前端项目自动化构建工具——Webpack入门教程
参考资料:https://www.webpackjs.com/(中文文档) https://www.webpackjs.com/(官方文档)
首先有必要说明一下,本文侧重讲解webpack基本配置属性,不附带实例,将会以通俗易懂的形式地讲解;如若需要实例进行相关练习,可将本文作为理论基础;
Webpack是前端项目自动化构建工具,本质上,webpack 是一个现代 JavaScript 应用程序的静态模块打包器(module bundler)。当 webpack 处理应用程序时,它会递归地构建一个依赖关系图(dependency graph),其中包含应用程序需要的每个模块,然后将所有这些模块打包成一个或多个 bundle。(官网定义)。
那么用我们人话来说:webpack是一个前端模块化的解决方案,更侧重点打包,可以把开发中的资源文件(图片、js文件、css文件等)看成是一个个的模块,然后通过webpack提供的loader(加载器)和plugins(插件)来进行处理、合并以及压缩,打包成符合生产环境、体积更小的文件资源,以方便提升浏览器的渲染速度;
首先我们要理解一下webpack的四大核心概念:
入口(entry)
出口(output)
loader(加载器)
plugins(插件)
入口(entry):
webpack入口指的是通过配置来指示webpack的入口文件,即从哪里开始,我们可以在webpack中配置entry属性,来指定入口文件的路径;
我们可以看一个简单的案例:
//必须将模块抛出webpack才能访问得到 module.exports = { //entry属性指定入口文件 值为相对路径 entry: './src/app.js' }
出口(output):
出口即告诉webpack在哪里输出它所创建的bundles,以及如何命名这些文件,输出的文件目录路径;也就是说在你用webpack打包的时候可以通过添加output属性,来设置最终经过webpack打包输出后的文件名以及输出路径;
//引入node的path模块 const path = require('path'); module.exports = { // webpack执行入口文件 entry: './src/app.js', //出口 output: { // 把所有依赖的模块合并输出到一个 bundle.js 文件 filename: 'bundle.js', // 输出文件都放到 dist 目录下 //__dirname是node环境中全局变量,表示当前目录 path: path.resolve(__dirname, './dist'), } };
加载器(loader):
loader是让webpack能够去处理一些非Javscript类型的文件(webpack自身只能够识别原生JS和ES5),loader可以将所有类型的文件转为webpack能处理的有效模块,然后就可以通过webpack的打包能力,对这些文件进行处理;loader的配置有两个选项:
test:一般都是正则表达式,用于匹配文件类型;
use:可以是key:value的形式也可以是数组,用来告诉webpack使用什么loader来加载文件
//引入node的path模块 const path = require('path'); module.exports = { // webpack执行入口文件 entry: './src/app.js', //出口 output: { // 把所有依赖的模块合并输出到一个 bundle.js 文件 filename: 'bundle.js', // 输出文件都放到 dist 目录下 //__dirname是node环境中全局变量,表示当前目录 path: path.resolve(__dirname, './dist'), } //模块关键字,加载器需要在这里进行配置 module:{ //rules为数组,保存每个加载器的配置 rules:[ { //test属性必须配置,值为正则表达式,用于匹配文件 test:/\.css$/, // 对同一个文件引入多个loader的方法 use:[ //loader为loader加载器的名称,必须配置,值为字符串 {loader:"style-loader"}, {loader:"css-loader"} ], //过滤,排除node_module目录下的文件 exclude:/node_module/, //指定匹配文件的范围 指定/demo/目录下的.css文件进行匹配 include:/demo/ } ] } };
webpack中规定,在webpack中定义loader时,需要定义在module.rules中,否则会报错;test和use两个属性分别指定了匹配文件的规则和用什么loader来处理,这两个属性都是必选的,exclude、include分别表示过滤(不处理)某个文件中的文件和指定(处理)某个文件夹中的文件,这两个属性都是可选项;
插件(plugins):
loader 被用于转换某些类型的模块,而插件则可以用于执行范围更广的任务。插件的范围包括,从打包优化和压缩,一直到重新定义环境中的变量。插件接口功能极其强大,可以用来处理各种各样的任务。要使用某个插件,你需要require(引入)插件,然后添加到plugins数组中,多数插件可以通过选项option来自定义
//引入node的path模块 const path = require('path'); //引入extract-text-webpack-plugin插件 const ExtractTextPlugin = require('extract-text-webpack-plugin'); module.exports = { // webpack执行入口文件 entry: './src/app.js', //出口 output: { // 把所有依赖的模块合并输出到一个 bundle.js 文件 filename: 'bundle.js', // 输出文件都放到 dist 目录下 //__dirname是node环境中全局变量,表示当前目录 path: path.resolve(__dirname, './dist'), } //模块关键字,加载器需要在这里进行配置 module:{ //rules为数组,保存每个加载器的配置 rules:[ { //test属性必须配置,值为正则表达式,用于匹配文件 test:/\.css$/, // 对同一个文件引入多个loader的方法 use:[ //loader为loader加载器的名称,必须配置,值为字符串 {loader:"style-loader"}, {loader:"css-loader"} ], //过滤,排除node_module目录下的文件 exclude:/node_module/, //指定匹配文件的范围 指定/demo/目录下的.css文件进行匹配 include:/demo/ } ] } //配置插件 plugins: [ new ExtractTextPlugin({ //自定义配置插件选项 // 从 .js 文件中提取出来的 .css 文件的名称 filename: `[name]_[md5:contenthash:hex:8].css`, }), ] };
上面就是webpack的四大核心概念,下面我们来介绍一些常用的插件:
loader处理css和Sass:
默认情况下webpack是处理不了CSS的代码的,但是我们可以通过webpack的loader加载器来处理;
module.exports = { entry: './src/app.js', output: { path: __dirname + '/dist', filename: 'app.bundle.js' }, module: { rules: [ { test: /\.css$/, use: [ 'style-loader', 'css-loader' ] } ] } };
在日常开发中,我们只需要在webpack.config.js文件中写上上面的配置代码即可让webpack来处理CSS代码和Sass代码;
webpack-dev-server:
webpack-dev-server是webpack的一个常用插件,可以用来在本地上开启服务、启动浏览器并且可以实时监听文件修改;
module.exports = { entry: './src/app.js', ... //进行webpack-dev-server插件配置 devServer: { //端口号,默认8080,可以自定义修改 port: 9000, //运行webpack-dev-server的时候自动打开浏览器 open: true }, ... };
source-map调试:
开发总是离不开调试,但是我们用webpack给项目打包了之后,我们是很不方便找到错误或者问题所在的,当然webpack也想到了这一点,因此webpack给我们提供了source-map来进行调试;
devtool选项
source-map
配置结果
在一个单独的文件中产生一个完整且功能完全的文件。这个文件具有最好的source map,但是它会减慢打包速度;
devtool选项
cheap-module-source-map
配置结果
在一个单独的文件中生成一个不带列映射的map,不带列映射提高了打包速度,但是也使得浏览器开发者工具只能对应到具体的行,不能对应到具体的列(符号),会对调试造成不便;
devtool选项
eval-source-map
配置结果
使用eval打包源文件模块,在同一个文件中生成干净的完整的source map。这个选项可以在不影响构建速度的前提下生成完整的sourcemap,但是对打包后输出的JS文件的执行具有性能和安全的隐患。在开发阶段这是一个非常好的选项,在生产阶段则一定不要启用这个选项;
devtool选项
cheap-module-eval-source-map
配置结果
这是在打包文件时最快的生成source map的方法,生成的Source Map会和打包后的JavaScript文件同行显示,没有列映射,和eval-source-map选项具有相似的缺点;
综上所述,从上到下打包速度越来越快,不过同时带来的副作用也越多,较快的打包速度的后果就是对打包后的文件的的执行有一定影响。在中小型项目中,eval-source-map是一个比较不错的选择;
cheap-module-eval-source-map方法构建速度更快,但是不利于调试,推荐在大型项目考虑时间成本时使用。
module.exports={ devtool:"eval-source-map", }
在webpack打包之后,如果报错我们是看不到源文件的,因为此时文件已经被webpack打包了,这很不方便我们的开发调试,source-map就是用来解决这个问题的,通过添加配置devtool:"eval-source-map"这一行简单的代码,我们即可在调试的时候看到我们的源文件进行调试;