中文官方文档 Webpack 3.10.0

一、概念介绍

本质上,webpack 是一个现代JavaScript 应用程序的静态模块打包器(module bundler)。当 webpack 处理应用程序时,它会递归地构建一个依赖关系图(dependency graph),其中包含应用程序需要的每个模块,然后将所有这些模块打包成一个或多个 bundle
它是高度可配置的,但是,在开始前你需要先理解四个核心概念:

  • 入口(entry)
  • 输出(output)
  • loader
  • 插件(plugins)

1、 入口(entry)

指定webpack从哪个模块开始构建项目,通过一下配置指定一个入口起点(或多个入口起点),被处理到称之为 bundles 的文件中:

1
2
3
4
// webpack.config.js
module.exports = {
entry: './path/to/my/entry/file.js'
}

更多entry配置项,查看 入口起点 output 了解。

2、出口(output)

处理打包生成的 bundles 文件,如指定输出文件位置,文件名等。

1
2
3
4
5
6
7
8
// webpack.config.js
module.exports = {
entry: './path/to/my/entry/file.js',
output: {
path: path.resolve(__dirname, 'dist'),
filename: 'test_name.bunlde.js'
}
}

更多output配置项,查看 输出 output 了解。

3、loader

loader 作用是将所有文件类型转换成webpack能处理的有效模块,然后就可以通过webpack将文件打包。
本质上,webpack loader将所有类型文件转换成应用程序的依赖图可以直接引用的模块。
特殊: 只有webpack支持 import 导入任何类型模块,如 .css,.vue 等文件。
webpack 配置 loader的两个目标:

  • 1.识别需要对应 loader 处理的文件。(使用test属性)
  • 2.转换文件使其能够添加到依赖图并最终添加到 bunlde 中。(使用use属性)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// webpack.config.js
const path = require('path');
const config = {
entry: './path/to/my/entry/file.js',
output: {
path: path.resolve(__dirname, 'dist'),
filename: 'my-first-webpack.bundle.js'
},
module: {
rules: [
{ test: /\.txt$/, use: 'raw-loader' }
// test/use 两个属性是必须的
]
}
}
module.exports = config;

更多loaders配置项,查看 loaders 了解。

4、插件(plugins)

使用插件可以执行范围更广的任务。通过 require() 引用后添加在 plugins 数组中。
另外如果需要多次使用同一个插件,则使用 new 操作符来创建它的一个实例。
安装html-webpack-plugin:

1
npm install html-webpack-plugin --save-dev

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
// webpack.config.js
const HtmlWebpackPlugin = require('html-webpack-plugin');
const webpack = require('webpack'); // 用于访问内置插件
const path = require('path');

const config = {
entry: './path/to/my/entry/file.js',
output: {
path: path.resolve(__dirname, 'dist'),
filename: 'my-first-webpack.bundle.js'
},
module: {
rules: [
{ test: /\.txt$/, use: 'raw-loader' }
]
},
plugins: [
new webpack.optimize.UglifyJsPlugin(),
new HtmlWebpackPlugin({template: './src/index.html'})
]
};

module.exports = config;

更多plugins配置项,查看 插件 plugins 了解。
查看 插件列表

二、入口起点(Entry Points)

webpack的 entry 属性不仅可以配置单个入口,还可以配置多个入口:

1、单个入口(简写)配置

用法:entry: string|Array<string>
简单使用 :

1
2
3
4
const config = {
entry: './path/to/my/entry/file.js'
};
module.exports = config;

entry 属性的单个入口配置方式:

1
2
3
4
5
const config = {
entry:{
main:'./path/to/my/entry/file.js'
}
}

若向 entry 传入 [文件路径(file path)数组],将创建 多个主入口,常常用在需要同时注入多个文件,并将它们的依赖导向(graph)到一个chunk时。

2、多个入口(简写)配置

对象语法

用法:entry: {[entryChunkName: string]: string|Array<string>}

1
2
3
4
5
6
7
8
9
// webpack.config.js
webpack.config.js

const config = {
entry: {
app: './src/app.js',
vendors: './src/vendors.js'
}
};

虽然语法繁琐,但这是应用程序中定义入口的最可扩展的方式。

“可扩展的 webpack 配置”是指,可重用并且可以与其他配置组合使用。这是一种流行的技术,用于将关注点(concern)从环境(environment)、构建目标(build target)、运行时(runtime)中分离。然后使用专门的工具(如 webpack-merge)将它们合并。

常见场景

列出一些常见的入口配置和实际案例:

(1)分离 应用程序(app) 和 第三方库(vendor) 入口

1
2
3
4
5
6
7
// webpack.config.js
const config = {
entry: {
app: './src/app.js',
vendors: './src/vendors.js'
}
};

webpack 从 app.js 和 vendors.js 开始构建,并且他们是完全分离互相独立,为了支持提供更佳 vendor 分离能力的 DllPlugin,考虑移除该场景。

(2)多页面应用程序

1
2
3
4
5
6
7
8
// webpack.config.js
const config = {
entry: {
pageOne: './src/pageOne/index.js',
pageTwo: './src/pageTwo/index.js',
pageThree: './src/pageThree/index.js'
}
};

这样告诉 webpack 需要 3 个独立分离的依赖图,
使用 CommonsChunkPlugin 为每个页面间的应用程序共享代码创建 bundle。
由于入口起点增多,多页应用能够复用入口起点之间的大量代码/模块,从而可以极大地从这些技术中受益。
根据经验:每个 HTML 文档只使用一个入口起点。

最后更新日期:2018.01.31