webpack性能优化(2):splitChunks用法详解
之前写的《webpack性能优化(0):webpack性能优化概况-优化构建速度》、《webpack性能优化(1):分隔/分包/异步加载+组件与路由懒加载》
如果使用vue-cli,默认生成的vendor.js文件会非常大。这个时候需要进行拆包。其实打包输出后,都可以用如下工具瞧瞧包依赖情况。
-
webpack-chart:用于webpack统计的交互式饼图。
-
webpack-visualizer:可视化并分析你的 bundle,检查哪些模块占用空间,哪些可能是重复使用的。
-
webpack-bundle-analyzer:一款分析 bundle 内容的插件及 CLI 工具,以便捷的、交互式、可缩放的树状图形式展现给用户。
第二是通过 Chrome 的 Instrument converge 功能查看 js,css 的资源使用率:https://developers.google.com/web/tools/chrome-devtools/coverage
优化输出与分包,原来熟悉的配方 new webpack.optimize.CommonsChunkPlugin({}),现在可直接配置optimization项目
在研究splitChunks之前,我们必须先弄明白 module、chunk和bundle 这三个名词是什么意思:
-
module:就是js的模块化webpack支持commonJS、ES6等模块化规范,简单来说就是你通过import语句引入的代码。
-
chunk: chunk是webpack根据功能拆分出来的,包含三种情况:
-
你的项目入口(entry)
-
通过import()动态引入的代码
-
通过splitChunks拆分出来的代码
chunk包含着module,可能是一对多也可能是一对一。
-
bundle:bundle是webpack打包之后的各个文件,一般就是和chunk是一对一的关系,bundle就是对chunk进行编译压缩打包等处理之后的产出。
代码分离 | Code Splitting
代码分离是 webpack 中最引人注目的特性之一。此特性能够把代码分离到不同的 bundle 中,然后可以按需加载或并行加载这些文件。代码分离可以用于获取更小的 bundle,以及控制资源加载优先级,如果使用合理,会极大影响加载时间。
有三种常用的代码分离方法:
-
入口点:使用entry配置手动分割代码。
这种方法存在一些缺陷
-
如果入口 chunks 之间包含重复的模块,那些重复模块都会被引入到各个 bundle 中。
-
这种方法不够灵活,并且不能将核心应用程序逻辑进行动态拆分代码。
-
防止复制:使用 CommonsChunkPlugin 去重和分离 chunk。将公共的依赖模块提取到已有的入口 chunk 中,或者提取到一个新生成的 chunk。
一些对于代码分离很有帮助的插件和 loaders:
-
ExtractTextPlugin:用于将CSS从主应用程序中分离出来。
-
bundle-loader:用于分离代码和延迟加载生成的 bundle。
-
promise-loader:类似于 bundle-loader ,但是使用的是 promises。
-
动态导入:通过模块的内联函数调用来分离代码。所谓的延迟加载|按需加载|懒加载
-
先选择的方式是,使用符合 ECMAScript 提案 的 import() 语法。
-
使用 webpack 特定的 require.ensure
其实我们一帮需要做的是optimization.splitChunks。以下是生产环境默认配置(webpack版本 4.29.5)
splitChunks: { hidePathInfo: true, chunks: 'all', minSize: 30000, minChunks: 1, maxAsyncRequests: 5, automaticNameDelimiter: '~', maxInitialRequests: 3, name: true, cacheGroups: { default: { reuseExistingChunk: true, minChunks: 2, priority: 20 }, vendors: { automaticNamePrefix: 'vendors', test: /[\\\/]node_modules[\\\/]/, priority: -10 } }}
splitChunks就算你什么配置都不做它也是生效的,源于webpack有一个默认配置,这也符合webpack4的开箱即用的特性。
我们需要在整个基础上进行优化,所以需要熟悉里面的配置
splitChunks配置解说
配置项也是蛮多,这里抽取一些重点说明,更加详细还是看文档。
splitChunks.maxAnyscRequests 按需加载并发最大请求数
maxInitialRequests是splitChunks里面比较难以理解的点之一,它表示允许入口并行加载的最大请求数,之所以有这个配置也是为了对拆分数量进行限制,不至于拆分出太多模块导致请求数量过多而得不偿失。
这里需要注意几点:
-
入口文件本身算一个请求
-
如果入口里面有动态加载得模块这个不算在内
-
通过runtimeChunk拆分出的runtime不算在内
-
只算js文件的请求,css不算在内
-
如果同时又两个模块满足cacheGroup的规则要进行拆分,但是maxInitialRequests的值只能允许再拆分一个模块,那尺寸更大的模块会被拆分出来
具体参考《理解webpack4.splitChunks之maxInitialRequests》
splitChunks.maxAsyncRequests
maxAsyncRequests和maxInitialRequests有相似之处,它俩都是用来限制拆分数量的。
-
maxInitialRequests是用来限制入口的拆分数量
-
maxAsyncRequests是用来限制异步模块内部的并行最大请求数的,说白了你可以理解为是每个import()它里面的最大并行请求数量。
这其中要注意以下几点:
-
import()文件本身算一个请求
-
并不算js以外的公共资源请求比如css
-
如果同时有两个模块满足cacheGroup的规则要进行拆分,但是maxInitialRequests的值只能允许再拆分一个模块,那尺寸更大的模块会被拆分出来
具体参看《理解webpack4.splitChunks之maxAsyncRequests》
splitChunks.minChunks
这个配置表示 split 前单个非按需导入的 module 的并行数的最低下限。
注:只对 import 或 require 直接引入的 module 有效。
简单来讲,假如 minChunks 设置为 n,那么某个 module 想要被拆分出去,那么它的共享次数(或者说并行请求次数必须 >= n):
minChunks设置为n
-
假设有m个入口点,这m个入口点都直接引入了某个模块module(通过import或require直接或间接地引入了模块),也就是共享次数为m
-
当m至少等于n时,module才会被单独拆分成一个bundle
但是,有个特例
minChunks设置成1
-
有一个入口点,入口点中import了一个模块,并打印了某些字符串,我们就叫它module
-
module被单独拆分成一个bundle,并且这个bundle文件中也包含了打印字符串的部分
我们注意到拆分出来的那个 bundle 包含了打印字符串的部分,那么如果入口点中仅仅包含了打印字符串的部分,没有引入 module,结果是怎样呢,结果就是打印的那部分代码被单独拆分出来了。所以当 minChunks 被设为 1 时,被拆分出来的某个 bundle 一定包含非引入模块代码,如果非引入模块代码存在的话,而当值设为大于 1 的数值时,则不会出现这种情况。
最后,还有一个点需要注意,minChunks 不能设为 0,其值为 >= 1 的正整数,不然为报错。
minChunks设置成Infinity
搞懂了minChunks的number属性,Infinity属性就很好理解了。Infinity是不会把任何依赖的模块提取出来打包公用。
splitChunks.minChunks用法总结
-
splitChunks.minChunks 表示 split 前单个非按需导入的 module 的并行数的最低下限,即某个模块的引用次数必须大于等于设置的数值,该模块才能被拆分出来;
-
splitChunks.minChunks 值如果设为 1,会存在被拆分出来的 bundle 包含非引入模块代码的可能,大于 1 则不会有这种情况;
-
splitChunks.minChunks 值必须大于等于 1;
minSize与maxSize
minSize限制拆分包的最小值(达到这个值,就拆出新包)
maxSize限制每个拆分出来的包的最大文件体积(超过这个大小,再做包拆分
cacheGroups 缓存组
cacheGroups其实是splitChunks里面最核心的配置,一开始我还认为cacheGroups是可有可无的,这是完全错误的,splitChunks就是根据cacheGroups去拆分模块的,包括之前说的chunks属性和之后要介绍的种种属性其实都是对缓存组进行配置的。
缓存组可以继承重写SplitChunks中的任何属性;但是test、priority和ReuseExistingChunk只能在缓存组级别配置 . 也就是说真正起作用的是cacheGroups, SplitChunks中设置属性仅仅是基本配置而已。
CacheGroups之外设置的约束条件比如说默认配置里面的chunks、minSize、minChunks等等都会作用于cacheGroups,除了test, priority and reuseExistingChunk,这三个是只能定义在cacheGroup这一层的。
因为默认的minChunks=1,这个属性会作用于所有的cacheGroups,但是cacheGroups也可以将上面的所有属性都重新定义,就会覆盖外面的默认属性,比如default这个缓存组就设置了minChunks=2,他会覆盖掉默认值1。
splitChunks默认有两个缓存组:vender(webpack5 默认为defaultVendors)和default,
optimization.runtimeChunk
优化持久化缓存的, runtime 指的是 webpack 的运行环境(具体作用就是模块解析, 加载) 和 模块信息清单,
模块信息清单在每次有模块变更(hash 变更)时都会变更, 所以我们想把这部分代码单独打包出来, 配合后端缓存策略, 这样就不会因为某个模块的变更导致包含模块信息的模块(通常会被包含在最后一个 bundle 中)缓存失效.
optimization.runtimeChunk 就是告诉 webpack 是否要把这部分单独打包出来.
何为运行时代码?
形如import('abc').then(res=>{})这种异步加载的代码,在webpack中即为运行时代码。
设置runtimeChunk是将包含chunks 映射关系的 list单独从 app.js里提取出来,因为每一个 chunk 的 id 基本都是基于内容 hash 出来的,所以每次改动都会影响它,如果不将它提取出来的话,等于app.js每次都会改变。缓存就失效了。设置runtimeChunk之后,webpack就会生成一个个runtime~xxx.js的文件。
然后每次更改所谓的运行时代码文件时,打包构建时app.js的hash值是不会改变的。如果每次项目更新都会更改app.js的hash值,那么用户端浏览器每次都需要重新加载变化的app.js,如果项目大切优化分包没做好的话会导致第一次加载很耗时,导致用户体验变差。
现在设置了runtimeChunk,就解决了这样的问题。所以这样做的目的是避免文件的频繁变更导致浏览器缓存失效,所以其是更好的利用缓存。提升用户体验。
runtimeChunk作用是为了线上更新版本时,充分利用浏览器缓存,使用户感知的影响到最低。
具体参看《webpack之optimization.runtimeChunk作用》
下面是一个参考配置:
// 当我们运行项目并且打包的时候,会发现chunk-vendors.js这个文件非常大,那是因为webpack将所有的依赖全都压缩到了这个文件里面,这时我们可以将其拆分,将所有的依赖都打包成单独的js。 config.optimization = { mergeDuplicateChunks: true, // 合并相同的 chunk // runtimeChunk: 'manifest', // runtimeChunk: 'single', splitChunks: { chunks: 'async',//表示将选择哪些块进行优化。提供字符的有效值为all、async和initial,默认是仅对异步加载的块进行分割。 minSize: 100 * 1024,//模块大于minSize时才会被分割出来。默认100k maxSize: 0,//生成的块的最大大小,如果超过了这个限制,大块会被拆分成多个小块。 minChunks: 1,//拆分前必须共享模块的最小块数。 maxAsyncRequests: 5,//按需加载时并行请求的最大数目。 maxInitialRequests: 3,//入口点的最大并行请求数 automaticNameDelimiter: '~',//默认情况下,webpack将使用块的来源和名称(例如vendors~main.js)生成名称。此选项允许您指定要用于生成的名称的分隔符。 automaticNameMaxLength: 30,//允许为SplitChunksPlugin生成的块名称的最大长度 name: true, cacheGroups: { elementUI: { priority: 20, name: 'element-ui', test: /element-ui/, reuseExistingChunk: true }, vendor: { name: `chunk-vendors`, test: /[\\/]node_modules[\\/]/,//控制此缓存组选择的模块。省略它将选择所有模块。它可以匹配绝对模块资源路径或块名称。匹配块名称时,将选择块中的所有模块。 minChunks: 1, // maxInitialRequests: 12, maxAsyncRequests: 5, minSize: 100 * 1024, maxSize: 5 * 1000 * 1024, priority: -10//一个模块可以属于多个缓存组,模块出现在优先级最高的缓存组中 }, common: { name: `chunk-common`, minChunks: 2, priority: -20, chunks: 'initial', reuseExistingChunk: true//如果当前块包含已经从主包中分离出来的模块,那么该模块将被重用,而不是生成新的模块 } } } }
如果有更好的办法,请赐教。
externals配置
启用CDN,提高缓存效率与打包分析,具体参看《webpack性能优化(0):webpack性能优化概况-优化构建速度 》
路由懒加载分组
分组修改方法如下:
const Role = () => import(/* webpackChunkName: "group-role" */'./views/system/Role.vue') const AddRole = () => import(/* webpackChunkName: "group-role" */'./views/system/AddRole.vue') const EditRole = () => import(/* webpackChunkName: "group-role" */'./views/system/EditRole.vue') const User = () => import(/* webpackChunkName: "group-user" */'./views/system/User.vue') const AddUser = () => import(/* webpackChunkName: "group-user" */'./views/system/AddUser.vue') const EditUser = () => import(/* webpackChunkName: "group-user" */'./views/system/EditUser.vue') const UserAllotRole = () => import(/* webpackChunkName: "group-user" */'./views/system/UserAllotRole.vue')
每个功能模块打包后的 js 大概有十几kb,文件数量也大大减少。
performance性能监控
这些限制告诉webpack如何/何时拆分块,它们仅定义了限制值,在限制值以上,警告在控制台中显示,仅此而已。
entrypoint size limit: The following entrypoint(s) combined asset size exceeds the recommended limit (244 KiB). This can impact web performance.
performance: { maxEntrypointSize: 512000, maxAssetSize: 512000 }
参考文章:
webpack4 之 splitChunks.minChunks https://zhuanlan.zhihu.com/p/110175375
理解webpack4.splitChunks https://www.cnblogs.com/kwzm/p/10314438.html
vuecli3项目中webpack4配置(三)代码分割 https://juejin.im/post/6844903879046332424
转载本站文章《webpack性能优化(2):splitChunks用法详解》,
请注明出处:https://www.zhoulujun.cn/html/tools/Bundler/webpackTheory/8554.html