简介
webpack 是一个前端资源加载/打包工具。
webpack 是一个 JavaScript 应用程序的静态模块打包器(module bundler)。当 webpack 处理应用程序时,它会递归地构建一个依赖关系图(dependency graph),其中包含应用程序需要的每个模块,然后将所有这些模块打包成一个或多个 bundle。
webpack 可以将多种静态资源(js、css、less、sass等) 转换、打包成一个或多个静态文件。
在 webpack 中,"一切皆模块”,它把 js 文件视作模块,其他的(如 css、png、sass 等)文件也视作模块。
webpack 4.0.0 的特性
- CLI 被单独分离到 webpack-cli 包,需单独安装。
- 默认将 ./src/index.js 作为入口,将 ./dist/main.js 作为输出。
- 引入开发(development)和生产(production)模式,必须通过 --mode 选项指定一种模式。
- 移除了一些常用的内置插件,可使用新的内置插件代替。
主要概念
webpack 是高度可配置的,默认的配置文件是 webpack.config.js,你需要先理解四个主要概念:
- 入口(entry)
- 输出(output)
- loader
- 插件(plugins)
入口(entry)
入口 指定了 webpack 应该使用哪个模块,来作为构建其内部依赖图的开始。
进入入口后,webpack 会找出有哪些模块和库是入口起点(直接和间接)依赖的。
每个依赖项随即被处理,最后输出到称之为 bundles 的文件中。
可以通过在 webpack 配置中配置 entry 属性,来指定一个或多个入口起点。
下面是一个 entry 配置的最简单例子:
webpack.config.js
module.exports = {
entry: './path/to/my/entry/file.js'
};
输出(output)
输出(output)告诉 webpack 在哪里输出它所创建的 bundles,以及如何命名这些文件。
你可以在配置中通过 output 属性进行设定。
const path = require('path');
module.exports = {
entry: './path/to/my/entry/file.js',
output: {
path: path.resolve(__dirname, 'dist'),
filename: 'my-first-webpack.bundle.js'
}
};
loader
loader 使 webpack 能够去处理那些非 JavaScript 文件(webpack 自身只理解 JavaScript)。loader 可以将所有类型的文件转换为 webpack 能够处理的有效模块,然后你就可以利用 webpack 的打包功能,对它们进行处理。
loader 能够 import 导入任何类型的模块(例如 .css 文件)。
在 webpack 的配置中 loader 有两个目标:
- test 属性,指定哪些文件需要被 loader 转换。
- use 属性,指定进行转换时,应该使用哪个 loader。
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' }
]
}
};
module.exports = config;
上述示例中,对一个单独的 module 对象定义了 rules 属性,rules 属性里面包含两个必须属性:test 和 use。它告诉 webpack 的编译器:当碰到「require()/import 语句中被解析为 '.txt' 的路径」时,在对它打包之前,先使用 raw-loader 进行转换。
注意: 在 webpack 配置中定义 loader 时,要定义在 module.rules 中,而不是 rules。
插件(plugins)
loader 被用于转换某些类型的模块,而插件则可以用于执行范围更广的任务。
插件的功能包括,从打包优化和压缩,一直到重新定义环境中的变量。
插件接口功能极其强大,可以用来处理各种各样的任务。
想要使用一个插件,你只需要 require() 它,然后把它添加到 plugins 数组中。多数插件可以自定义参数。
const HtmlWebpackPlugin = require('html-webpack-plugin'); // 通过 npm 安装
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;
安装
前提条件
在安装 webpack 之前,你必须先安装 node.js,然后通过 node.js 的 npm 工具来安装 webpack。
本地安装
要安装最新版本或特定版本的 webpack ,请运行以下命令之一:
npm install --save-dev webpack
npm install --save-dev webpack@<version>
推荐本地安装。这可以使我们在引入破坏式变更的依赖时,更容易分别升级项目。通常,webpack 通过运行一个或多个 npm 脚本,会在本地 node_modules 目录中查找安装的 webpack:
"scripts": {
"start": "webpack --config webpack.config.js"
}
说明:当你在本地安装 webpack 后,你能够从 node_modules/.bin/webpack 访问它的 bin 版本。
注意: webpack 4.0.0 中,将 CLI 单独分离到了 webpack-cli 包中,如果想在 CLI 中运行 webpack,就必须单独安装 webpack-cli。
npm install --save-dev webpack-cli
全局安装
npm install --global webpack
npm install --global webpack-cli
初步使用
webpack 用于编译 JavaScript 模块。一旦完成安装,你就可以通过 webpack 的 CLI 或 API 与 webpack 进行交互。