1. 什么是webpack

作为前端开发者,webpack可谓是家喻户晓的构建工具!那么,我们先来看看英文官方对于webpack的定义和说明:

webpack is a static module bundler for modern JavaScript applications. When webpack processes your application, it internally builds a dependency graph which maps every module your project needs and generates one or more bundles.

webpack 是一个现代 JavaScript 应用程序的静态模块打包器(module bundler)。当 webpack 处理应用程序时,它会递归地构建一个依赖关系图(dependency graph),其中包含应用程序需要的每个模块,然后将所有这些模块打包成一个或多个 bundle。

webPack 可以看做是模块打包机:它做的事情是,分析你的项目结构,找到JavaScript模块以及其它的一些浏览器不能直接运行的拓展语言(Scss,TypeScript等),并将其打包为合适的格式以供浏览器使用。

webpack 的工作方式是:把你的项目当做一个整体,通过一个给定的主文件(如:index.js),Webpack将从这个文件开始找到你的项目的所有依赖文件,使用loaders处理它们,最后打包为一个(或多个)浏览器可识别的JavaScript文件。

2. webpack配置的核心概念

2.1 entry(打包入口)

入口起点(entry point)指示 webpack 应该使用哪个模块,来作为构建其内部依赖图的开始。进入入口起点后,webpack 会找出有哪些模块和库是入口起点(直接和间接)依赖的。就vue项目来说,通常入口文件为main.js文件。

entry 通常有三种写法:

第一种:字符串形式,如下:

1
2
3
4
// webpack.config.js
module.exports = {
entry: './src/layout/main.js'
}

第二种:数组形式,如下:

1
2
3
4
// webpack.config.js
module.exports = {
entry: ['./src/layout/main.js']
}

第三种:对象形式,如下:

1
2
3
4
5
6
// webpack.config.js
module.exports = {
entry: {
app: './src/layout/main.js'
}
}

对于这三种写法,通常开发者都会采用第三种,实际上,我们也推荐第三种写法,不论是可扩展性还是代码可读性,第三种都秒杀前两种!

2.2 output(打包出口)

output 属性告诉 webpack 在哪里输出它所创建的 bundles,以及如何命名这些文件,默认值为 ./dist。基本上,整个应用程序结构,都会被编译到你指定的输出路径的文件夹中。你可以通过在配置中指定一个 output 字段,来配置这些处理过程:

1
2
3
4
5
6
7
8
9
10
// webpack.config.js
const path = require('path');

module.exports = {
entry: './src/layout/main.js',
output: {
path: path.resolve(__dirname, 'dist'),
filename: '[name].bundle.[hash:8].js'
}
};

在上面的示例中,我们通过 output.filename 和 output.path 属性,来告诉 webpack bundle 的名称,以及我们想要 bundle 生成(emit)到哪里。可能你想要了解在代码最上面导入的 path 模块是什么,它是一个 Node.js 核心模块,用于操作文件路径。

关于output还有很多可配置的属性,详情参见webpack官方文档output配置,在此不再赘述了。

2.3 loaders(处理非js文件)

loader 让 webpack 能够去处理那些非 JavaScript 文件(webpack 自身只理解 JavaScript)。loader 可以将所有类型的文件转换为 webpack 能够处理的有效模块,然后你就可以利用 webpack 的打包能力,对它们进行处理。

本质上,webpack loader 将所有类型的文件,转换为应用程序的依赖图(和最终的 bundle)可以直接引用的模块。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// webpack.config.js
const path = require('path');

module.exports = {
entry: './src/layout/main.js',
output: {
path: path.resolve(__dirname, 'dist'),
filename: '[name].bundle.[hash:8].js'
},
module: {
rules: [
{
test: /\.js$/,
loader: 'babel-loader',
exclude: /node_modules/
},
{
test: /\.(png|jpg|gif|svg)$/,
loader: 'url-loader',
options: {
name: '[name].[ext]?[hash]'
}
}
]
}
};

如上,可以看到module种配置rules规则,使用babel-loader来处理js文件,使用url-loader来处理图片文件。

常用的loader:

  1. 编译相关:babel-loader,ts-loader;

  2. 样式相关:style-loader,css-loader,less-loader,sass-loader,postcss-loader;

  3. 文件相关:file-loader,url-loader;

2.4 plugins(插件)

loader 被用于转换某些类型的模块,而插件则可以用于执行范围更广的任务。插件的范围包括,从打包优化和压缩,一直到重新定义环境中的变量。插件接口功能极其强大,可以用来处理各种各样的任务。

想要使用一个插件,你只需要 require() 它,然后把它添加到 plugins 数组中。多数插件可以通过选项(option)自定义。你也可以在一个配置文件中因为不同目的而多次使用同一个插件,这时需要通过使用 new 操作符来创建它的一个实例。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// webpack.config.js
const path = require('path');
const webpack = require('webpack');
const HtmlWebpackPlugin = require('html-webpack-plugin'); // 通过 npm 安装

module.exports = {
entry: './src/layout/main.js',
output: {
path: path.resolve(__dirname, 'dist'),
filename: '[name].bundle.[hash:8].js'
},
module: {
rules: [
{
test: /\.js$/,
loader: 'babel-loader',
exclude: /node_modules/
},
{
test: /\.(png|jpg|gif|svg)$/,
loader: 'url-loader',
options: {
name: '[name].[ext]?[hash]'
}
}
]
},
plugins: [
new HtmlWebpackPlugin({template: './src/index.html'}),
new webpack.DefinePlugin({
'process.env': {
NODE_ENV: '"production"'
}
}),
new webpack.optimize.UglifyJsPlugin({
sourceMap: true,
compress: {
warnings: false
}
}),
new webpack.LoaderOptionsPlugin({
minimize: true
})
]
};

webpack 提供许多开箱可用的插件!具体可以查阅webpack官方文档

2.5 mode(模式)

通过选择 development 或 production 之中的一个,来设置 mode 参数,你可以启用相应模式下的 webpack 内置的优化。

1
2
3
4
// webpack.config.js
module.exports = {
mode: 'production' // "production" | "development" | "none"
};