webpack4 配置解析和实战
webpack4特性
webpack4比较热门的两大特性,零配置和速度快(号称提速上限98%)
一般情况下,webpack4相比于低版本,production场景下第三方依赖打包速度 和 development场景下本地服务首次启动速度 都得到显著提升
零配置
通过mode指定当前场景为开发模式还是生产模式,自动设置好当前场景的默认配置,用户即可马上使用,不需要多余的配置
打包速度快
打包速度之所以能得到显著提升,多亏了Optimization这个新增的选项,下文会说到
配置选项说明
1.入口(entry)
是应用程序,或者说一个页面的起点入口,如果传递一个数组,那么数组的每一项都会执行
每个html页面都有一个入口起点
单页面应用(SPA):一个入口
多页面应用(MPA :多个入口
entry: { home: "./home.js", about: "./about.js", contact: "./contact.js" }
如果entry的值是一个字符串,那么打包之后的chunk名即为默认的main
如果entry的值是一个对象,则每个key都会是chunk的名字,每个key对应的值都是入口起点
2.输出(output)
output的值必须为一个对象,至少包含下面两个属性
filename: webpack打包之后输出文件的路径
path: 决定了每个输出的bundle的名称(即打包后的文件名字),这些bundle将写入到output.path指定的目录下
例如:
单入口
output: { path: '/dist', filename: 'bundle.js' }
这个配置将会在根目录的dist文件夹下输出打包后的bundle.js,这是单页面应用的配置
多入口
output: { path: '/dist', filename: 'js/[name].js' }
即在dist目录下的js文件夹中输出一系列的bundle
一个比较难理解的配置:ouput.publicPath
配置html中引用的静态资源的目录,在多数情况下,此选项的值为'/'
publicPath并不会对webpack打包文件后存放的目录有所影响,是对生成的html中应用的静态资源,比如图片,css和js文件的引用路径做对应的补足
对于按需加载或者加载外部资源来说,这个选项的值尤为重要,如果设置错误,加载资源的时候会返回404
3.模块加载器(loader)
loaders可以说是各种模块的转换器,可以用来预处理文件,解析和打包除javascript之外的任何静态资源
loader要下载才能配置使用,比如:
npm install --save-dev css-loader
npm install --save-dev ts-loader
然后在webpack的配置文件中,声明,css后缀的文件使用css-loader解析,ts后缀的文件使用ts-loader解析
module.exports = { module: { rules: [ { test: /\.css$/, use: 'css-loader' }, { test: /\.ts$/, use: 'ts-loader' } ] } };
更多loader的配置:webpack loaders
4.插件(plugins)
plugins用于自定义webpack的构建过程, 比如自定义打包之后的html模板,自定义js和样式文件是否打包等等
plugins的值,是一个个new出来的插件实例
webpack4取消了四个常用的用于性能优化的pluginUglifyjsWebpackPlugin,CommonsChunkPlugin,ModuleConcatenationPlugin,NoEmitOnErrorsPlugin
转而提供了一个名为optimization的配置项,用于替代以上四个插件(并不是说以上插件不能使用了,只是webpack4本身有替代的方案,可以不用插件)
html-webpack-plugin
通过new 该插件的实例,可以让webpack帮我们编译出一个html文件
需要注意的是,多页面的配置下,有多少个页面,就要new多少个实例,传入到plugins中,后面有代码示例。
html-webpack-inline-source-plugin
这个插件用于生产模式下,让webpack在打包的时候,将js和css直接插入到html中,从而减少请求的消耗
要注意的是,并不是所有情况下都适合用,文件较大时,还是推荐通过标签去引入资源(运行时文件一般比较小,下面会通过另一个插件将runtime的代码直接插入html中)
更多插件及其配置:webpack plugins
5.模式(mode)
mode是webpack4新增的参数选项,它有三个值,development、production、none,
由于开发模式和生产模式所需要的webpack的配置稍微有单不同(但是大部分是相同的)
所以可以建立两个webpack的配置文件,分别用于开发模式和生产模式,除此之外,指明当前处于哪个模式下,有利于webpack内部做优化
比如,有一些插件是在生产模式下才启用的。
通过指定mode的值为development和production中的一个,来表示webpack处于何种模式下,默认值是production
mode为 development 时,注重提升代码的构建速度和开发体验
module.exports = { mode: 'development', cache: true, devtools: "eval", plugins: [ new webpack.NamedModulesPlugin(), new webpack.DefinePlugin({ "process.env.NODE_ENV": JSON.stringify("development") }) ] };
mode为 production 时,提供代码优化,如压缩、作用域提升等
module.exports = { mode: 'production', plugins: [ new UglifyJsPlugin(/* ... */), new webpack.DefinePlugin({ "process.env.NODE_ENV": JSON.stringify("production") }), new webpack.optimize.ModuleConcatenationPlugin(), new webpack.NoEmitOnErrorsPlugin() ] }
也可以通过命令行运行下面的命令来指定模式
webpack --mode=production
6.优化(optimization)
这个选项也是wepack4新增的,主要用来自定义一些优化打包的策略
minimizer
在production模式下,该配置会默认为我们压缩混淆代码,但配置项过于少导致无法满足我们对于优化代码的诉求,下面是一套比较灵活的优化配置
var UglifyJsPlugin = require('uglifyjs-webpack-plugin') var OptimizeCssAssetsPlugin = require('optimize-css-assets-webpack-plugin') module.exports = { optimization: { minimizer: [ // 自定义js优化配置,将会覆盖默认配置 new UglifyJsPlugin({ exclude: /\.min\.js$/, // 过滤掉以".min.js"结尾的文件,我们认为这个后缀本身就是已经压缩好的代码,没必要进行二次压缩 cache: true, parallel: true, // 开启并行压缩,充分利用cpu sourceMap: false, extractComments: false, // 移除注释 uglifyOptions: { compress: { unused: true, warnings: false, drop_debugger: true }, output: { comments: false } } }), // 用于优化css文件 new OptimizeCssAssetsPlugin({ assetNameRegExp: /\.css$/g, cssProcessorOptions: { safe: true, autoprefixer: { disable: true }, //这里注意下!!!!! mergeLonghand: false, discardComments: { removeAll: true // 移除注释 } }, canPrint: true }) ] } }
UglifyJsPlugin是大家经常使用的插件,这里比较亮的地方是可以过滤本身已经压缩的js,可以提升打包速度,并且避免二次混淆压缩造成的未知bug
OptimizeCssAssetsPlugin用来优化css文件的输出,优化策略包括:摈弃重复的样式定义、砍掉样式规则中多余的参数、移除不需要的浏览器前缀等
这里注意插件的参数autoprefixer: { disable: true },一定要指定为true。否则的话该插件会把我们用autoprefix加好的前缀都移除掉(因为该插件觉得多余)
runtimeChunk
分离出webpack编译出来的运行时代码,也就是我们之前成为manifest的代码块,方便我们做文件的之就好缓存
这个参数项(runtimeChunk)有多种类型的值,其中,single即将所有的chunk的运行时代码打包到一个文件中,multiple即针对每个chunk的运行时代码分别打包出一个runtime文件
我们可以配合上面说到的 InlineManifestWebpackPlugin插件,将运行时代码直接插入html文件中,因为这段代码非常少,这样做可以避免一次请求的开销
InlineManifestWebpackPlugin插件的顺序一定要在HtmlWebpackPlugin之后,否则会导致编译失败
var HtmlWebpackPlugin = require('html-webpack-plugin') var InlineManifestWebpackPlugin = require('inline-manifest-webpack-plugin') module.exports = { optimization: { runtimeChunk: 'single' // 等价于 // runtimeChunk: { // name: 'runtime' // } }, plugins: [ new HtmlWebpackPlugin({ template: '../src/index.html', filename: 'article.html', chunks: ['article', 'vendors', 'runtime'] }), new InlineManifestWebpackPlugin(), //放在htmlWebpackPlugin的后面才能生效 ] }
splitChunks
这是比较难理解的一个配置项
webpack4移除了CommonsChunkPlugin插件,取而代之的是splitChunks
比较优雅的分离打包配置如下
splitChunks: { cacheGroups: { vendors: { test: /[\\/]node_modules[\\/]/, name: 'vendors', minSize: 30000, minChunks: 1, chunks: 'initial', priority: 1 // 该配置项是设置处理的优先级,数值越大越优先处理 }, commons: { test: /[\\/]src[\\/]common[\\/]/, name: 'commons', minSize: 30000, minChunks: 3, chunks: 'initial', priority: -1, reuseExistingChunk: true // 这个配置允许我们使用已经存在的代码块 } } }
这段配置,首先是将node_modules中的模块统一打包成vendors.js
它限制了分离文件的最小体积为30k(压缩之前的),因为webpack认为,小于30k的代码分离出来,还要额外小号一次请求去加载它,成本太高,这个值是通过大量的时间总结出来的
其次,还分离除了共享模块,比如src目录下有几个全局公用的js文件如utils等,可以单独抽出来打包成一个commons.js
由于这部分文件不经常改变,有利于持久缓存
完:demo地址