webpack详细教程

开心点啦.

已于 2023-12-18 08:48:18 修改

阅读量869

点赞数 7

文章标签： webpack 前端 node.js

于 2023-12-13 10:29:10 首次发布

本文链接：https://blog.csdn.net/zxcvb0825/article/details/134964422

版权

1，什么是webpackwebpack | webpack中文文档 | webpack中文网

Webpack 不仅是一个模块打包器(bundler)，更完整的讲是一个前端自动化构建工具。
在 Webpack 看来前端的所有资源文件(s/json/css/img/less/...)都会作为横块处理
它将根据模块的依赖关系进行静态分析，生成对应的静态资源.

五个核心概念

Entry:入起点(entry point)指示 webpack 应该使用哪个模块，来作为构建其内部依赖图的开始。
Output:output 属性告诉 webpack 在哪里输出它所创建的 bundles，以及如何命名这些文件
Loader: loader让webpack 能够去处理那些非JavaScript 文件
Plugins: 插件则可以用于执行范围更广的任务。例:打包优化、压缩
Mode:横式，有生产模式 production 和开发模式development

理解Loader

Webpack 本身只能加载JS/JSON 块，如果要加载其他类型的文件(模块)，就需要使用对应的loader进行转换/加载。
Loader 本身也是运行在 node.js 环境中的JavaScript 横块。
本身是一个函数，接受源文件作为参数，返回转换的结果。
loader 一般以xxx-loader 的方式命名，xxx代表了这个 loader 要做的转换功能，比如 less-loader。

理解Pligins

插件可以完成一些loader 不能完成的功能。
插件的使用一般是在 webpack 的配置信息 plugins 选项中指定。

Mode

模式(Mode)指示 webpack 使用相应模式的配置

配置文件(默认)

webpack.configjs:是一个 node 模块，返回一个json 格式的配置信息对象

2，安装webpack

全局安装（这一步暂时不需要做）

npm install webpack webpack-cli -g

局部安装

npm init
npm install webpack webpack-cli -D   # cli  Command Line Interface 命令行接口

官方推荐使用『局部安装』，这样可以避免因为版本不同而产生的 BUG

3，webpack初体验

1.创建JS模块: src/index.js

import data from './data.json'

console.log(data)

function add(x,y){
    return x + y;
}

console.log(add(1,2))

2,创建JSON模块: src/data.json

{
    "name":"jack",
    "age":18
}

3,创建css文件: src/index.css

html,body{
    height: 100%;
    background-color: pink;
}

4,安装

npm init -y
npm i webpack webpack-cli -D

5，执行打包命令『项目根目录下运行』

# 开发模式打包
npx webpack --entry ./src/index.js  --output-path ./build/js --output-filename bundle.js --mode development

webapck会以 ./src/index.js为入口文件开始打包，打包后输出到 ./build/bundle.js整体打包环境，是开发环境

# 生产模式打包
npx webpack --entry ./src/index.js  --output-path ./build/js --output-filename bundle2.js --mode production

webapck会以 ./src/index.js为入口文件开始打包，打包后输出到 ./build/bundle.js整体打包环境，是生产环境（对代码进行压缩到只剩下一行代码，在开发项目中对代码进行一个打包，解析速度等会变快）

–entry 设置入口
–output-path 设置输出目录
–output-filename 设置输出文件名
–mode 设置运行模式

区别 npm 与 npx ?

它们都是由Node提供的2个工具, 用来做工具包的相关处理
npm (Node Package Manager) : 包管理器, 用来下载工具包
npx (Node Package Excuted) : 包扩展工具, 用来运行工具包命令
npx 查找工具包的顺序: 局部查找 ==> 全局查找 ==> 运行

但是当在index.js中引入css样式，会进行一个报错

import "./index.css"

所以我们得到一个结论：

1.webpack能处理js/json资源，不能处理css/img等资源

2.生产环境和开发环境将ES6模块化编译成浏览器能识别的模块化~

3.生产环境比开发环境多一个压缩js代码

4，使用配置文件打包

问题：打包命令太复杂(需要指定打包的各种配置信息)

解决：通过JS类型的配置文件来指定打包的配置信息

项目根目录下创建文件 webpack.config.js，内容如下

const {resolve} = require('path'); // path模块是Node内置的
// __dirname：当前配置文件所在的目录绝对路径
// resolve: 用来拼接路径的函数

// 暴露配置对象
module.exports = {
    // 入口
    entry: './src/index.js',
  
    // 出口
    output: {
        path: resolve(__dirname, 'build'), // 打包文件所在的根目录
        filename: 'js/bundle.js', // 打包生成的js文件名(可以带目录)
        clean: true, // 打包时, 会先自动清空打包文件夹
    },
   
    // 模式
  	// mode: 'production',
    mode: 'development',
}

创建完毕之后，在项目根目录执行如下命令：

npx webpack

5，打包样式

切记，以下内容需要在配置文件打包的基础上进行添加，直接使用会报错

问题：webpack本身只能打包 JS 文件和 JSON 文件, 不能打包CSS文件

解决：利用css-loader & style-loader & less-loader 对CSS进行打包处理

首先是我们的准备工作

1,创建css文件：./src/index.css

html,body{
    margin: 0;
    padding: 0;
    height: 100%;
    background-color: pink;
}

2,创建less文件：./src/index.less

#title{
    color: #fff;
}

3.在入口JS文件中引入这些资源：./src/index.js

// 引入样式资源
import './index.css'  //只下载css-loader就只引入css文件 不然会报错
import './index.less' //只下载less-loader就只引入less文件 不然会报错

5-1：打包css文件

第一步：安装loader

npm i style-loader css-loader -D

第二步：修改webpack.config.js配置文件

module.exports = {
    mode: 'development',
    
    // 配置 loader
    module: {
        rules: [
          	// 配置 css 文件处理
            {
                test: /\.css$/, // 处理css文件
                use: [
                    "style-loader",		// 将 CSS 生成 style 标签插入 HTML 中
                    "css-loader"  		// 将 CSS 转为 CommonJS 的模块
                ]
            }   
        ]
    },
}

第三步：运行打包命令『在项目的根目录下运行』

npx webpack

5-2：打包less文件

第一步：安装loader

npm i less less-loader -D

第二步：配置loader

module.exports = {
    module: {
        rules: [
  		   // 配置 less 文件处理
            {
                test: /\.less$/, // 处理less文件
                use: [
                    'style-loader', // 将 CSS 生成 style 标签插入 HTML 中
                    'css-loader', // 将 CSS 转为 CommonJS 的模块
                    'less-loader' // 将Less编译为CSS
                ]
            },
        ]
    }
}

第三步：运行打包命令『在项目的根目录下运行』

npx webpack

6，打包HTML资源

问题：在HTML中手动引入打包文件比较麻烦，且没有压缩处理

解决：使用html-webpack-plugin打包HTML => 自动引入打包文件，压缩HTML

删除HTML中引入的JS打包文件
安装插件

npm i html-webpack-plugin -D

3.修改 webpack.config.js 配置文件

// 1. 引入插件
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
    plugins: [
      
      
       	// 2. 配置打包HTML的插件
        new HtmlWebpackPlugin({
            template: "./public/index.html",// 指定html模板文件。
            inject: "body",// 将打包生成的JS文件放置在body尾部
            hash: true,// 在引入JS时增加hash后缀字符串,去除缓存。
            filename:'index.html'
            minify: {
                removeAttributeQuotes: true,// 移除属性中的双引号
                removeComments: true,// 移除注释
                collapseWhitespace: true,// 去除空格与换行
            }
        })
      
    ]
}

4.执行打包命令

npx webpack  # 打包产生的页面自动引入js打包文件

5.静态资源要相对根目录查找，需要增加一个配置

output: {
        // 3-1. 指定出口文件的目录
        path: path.resolve(__dirname, '../dist'),
        // 3-2. 指定打包后的js文件名
        filename: 'js/app.bundle.js',
        // 3-3. 重新打包，清空以前的内容，重新生成
        clean: true,
        // 3-4. 静态资源目录
        publicPath:'/'
    },

5-1. 如何查看打包后的效果

方式一：在vscode中，以dist为根目录代开项目。这样liveserver 模拟的服务器 5500端口的根目录就是dist目录
方式二：
- 安装一个 serve 包，用它来模拟服务器，它可以指定根目录启动服务
- npm i -g serve
- 指定目录启动：
- serve 网站根目录名
- 举例：serve dist
根目概念：
- 项目根目路：指的是src所在目录
- 网站根目录：build之后的目录。当我们通过网址访问的时候，去哪个目录查找资源

7，打包图片资源

7-1. 打包 CSS和JS 中的图片

问题：在CSS或JS中我们都有可能引入图片, 如何打包这些图片文件呢?

解决：我们可以用内置的资源加载器来处理

参考文档：https://webpack.docschina.org/guides/asset-modules/

1，在CSS中引入图片

<div class="react"></div>
<div class="vue"></div>

拷贝图片react.png vue.png到src/img文件夹下

.react {
  width: 200px;
  height: 200px;
  float: left;
  margin-right: 20px;
  background: url('../images/react.png');
  background-size: cover;
}
.vue {
  width: 200px;
  height: 200px;
  float: left;
  background: url('../images/vue.png');
  background-size: cover;
}

2,修改 webpack.config.js

module.exports = {
    mode: 'development',
    module: {
        rules: [
       
        	// 处理图片
          {
              test: /\.(jpg|png|gif)$/,
              type: "asset",
              // 解析器
              parser: {
                // 指定进行图片base64编码最大文件大小
                dataUrlCondition: {
                  maxSize: 5 * 1024, // 5kb    默认8k
                }
              },
              // 打包生成的文件
              generator: {
                filename: 'images/[hash:8][ext]',
              },
           },
          
        ]
    }
}

3,重新打包

npx webpack

图片base64编码：对要引入的小图片转换为特定字符串，显示时还是为原图片

好处：减少HTTP请求，加快图片显示

限制：只合适小图片，如果是大图也做base64处理，会导致css/html文件过大，不利用页面显示

7-2. 打包 HTML 中的图片

问题：内置的资源打包器不能打包处理html中引入的图片

解决：利用html-loader打包html中引入的图片

1,HTML 结构中引入图片

拷贝图片 angular.png到public/img目录下

<img src="./img/angular.png" alt="">

2,安装 loader

npm i html-loader -D

3,配置 loader

module.exports = {
    module: {
        rules: [

		 // 配置 html 的 loader
            {
                test: /\.(html)$/,
                use: {
                    loader: 'html-loader'
                }
            }
          
        ]
    }
}

4,执行打包

npx webpack

需要移除 public/index.html 中的 script 标签, 否则会再次导入 JS, 造成打包失败

7-3. 打包字体图标

问题：项目中有可能引入字体图片文件来显示小图标, 如何打包字体图标呢?

解决：我们也可以用内置的资源加载器来处理

首先先下载一个阿里图标库中的项目，然后按照如下流程操作：

将字体文件复制到 src/fonts 目录下

iconfont.ttf / iconfont.woff / iconfont.woff2
复制 CSS 代码到样式文件中，这里可以是 CSS 文件，也可以是 LESS 文件

@font-face {
  font-family: 'iconfont';
  src: url('../fonts/iconfont.woff2?t=1652078424644') format('woff2'),
        url('../fonts/iconfont.woff?t=1652078424644') format('woff'),
        url('../fonts/iconfont.ttf?t=1652078424644') format('truetype');
}

.iconfont {
  font-family: "iconfont" !important;
  font-size: 16px;
  font-style: normal;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

3.HTML 结构中创建对应的 span 标签

<span class="iconfont">&#xe745;</span>

4.修改 webpack.config.js 配置文件

module.exports = {
    mode: 'development',
    module: {
        rules: [

  			// 打包字体图标
            {
              test: /\.(eot|svg|woff|woff2|ttf)$/,  
              type: 'asset/resource',
              generator: {
                filename: 'fonts/[hash:8][ext]',
              },
            },
          
        ]
    },
}

5.重新打包

npx webpack

8，打包JS

8-1：JS语法转换

问题：一些浏览器(尤其是IE)对ES6新语法的支持不够(不兼容), 但前端开发基本都在用ES6+的语法

解决：利用babel相关工具包将 ES6 转换为 ES5

Babel可以将浏览器不能识别的新语法（ES6-11）转换成原来识别的老语法（ES5），浏览器JS兼容性处理。操作流程：

1,安装babel相关工具包

npm install -D babel-loader @babel/core @babel/preset-env

@babel/core babel 的核心库 (本身并不能完成 ES6 转 ES5)
@babel/preset-env babel 的预设工具包，将 ES6 新语法转为 ES5
babel-loader babel 在 webpack 中的 loader 包

babel 插件包: 每个 ES6 的新语法都有一个对应的 babel 插件包来转换为对应的 ES5 语法

babel 预设包: 包含多个常用的 babel 插件包的一个大的集合包 ==> 简化配置

2,配置 loader

module.exports = {
    module: {
        rules: [
  		    //配置 babel 的 loader
            {
                test: /\.js$/,
                exclude: /node_modules/, // 不进行处理的文件夹
                use: {
                    loader: 'babel-loader',
                    options: {
                        presets: ['@babel/preset-env'], // 指定bebel预设包
      				   plugins: [], // 指定babel插件包
                    }
                }
            },
          
        ]
    }
}

3,设置目标浏览器

问题：webpack5 打包生成的 JS 代码默认是被包裹在『箭头函数』中，而IE不支持箭头函数

解决：在 package.json 配置说明兼容 IE 浏览器 => 打包文件中的箭头函数变为 function 函数

"browserslist": [
  "> 0.1%",
  "not ie <=8"
]

4,执行打包命令

npx webpack

5,babel单独配置文件使用

(1)在项目根目录[src所在目录]创建一个 .babelrc

{
    "presets": ["@babel/preset-env"]
}

(2)webpack.config.js

module.exports = {
    module: {
        rules: [
  		    //配置 babel 的 loader
            {
                test: /\.js$/,
                exclude: /node_modules/, // 不进行处理的文件夹
                use: 'babel-loader'
            },
          
        ]
    }
}

8-2. JS 兼容性处理

以下内容待更新....

开心点啦.

关注

7
点赞
踩
9

收藏

觉得还不错? 一键收藏
1
评论
webpack详细教程

webpack | webpack中文文档 | webpack中文网Webpack 不仅是一个模块打包器(bundler)，更完整的讲是一个前端自动化构建工具。在 Webpack 看来前端的所有资源文件(s/json/css/img/less/...)都会作为横块处理它将根据模块的依赖关系进行静态分析，生成对应的静态资源.
复制链接

扫一扫