React + Webpack 构建打包优化小白攻略
React 相关的优化
- 使用 babel-react-optimize 对 React 代码进行优化
- 检查没有使用的库,去除 import 引用
- 按需打包所用的类库,比如 lodash 、echarts 等
lodash 可以采用 babel-plugin-lodash 进行优化。
需要注意的是:在 babel-react-optimize 中使用了 babel-plugin-transform-react-remove-prop-types 这个插件。正常情况下,如果你在代码中没有引用到组件的 PropTypes,则完全没问题。如果你的组件用到了,那么使用该插件可能会导致问题。
具体见:https://github.com/oliviertassinari/babel-plugin-transform-react-remove-prop-types#is-it-safe
Webpack 构建打包优化
Webpack 构建打包存在的问题主要集中于下面两个方面:
- Webpack 构建速度慢
- Webpack 打包后的文件体积过大
Webpack 构建速度慢
可以使用 Webpack.DDLPlugin,HappyPack 来提高构建速度。具体参见小铭在 DMP DDLPlugin 的文档。原文如下:
Webpack.DLLPlugin
- 添加一个 webpack.dll.config.js
主要是用到一个 DllPlugin 插件,把一些第三方的资源独立打包,同时放到一个 manifest.json 配置文件中,
这样在组件中更新后,就不会重新 build 这些第三方的资源,
- 同时独立配置 dll/vendors.js 文件,提供给 webpack.dll.config.js
- 修改 package.json
在 scripts 中添加:
"dll": "webpack --config webpack.dll.config.js --progress --colors ",
执行 npm run dll 以后,会在 dll 目录下生产 两个文件 vendor-manifest.json ,vendor.dll.js,配置 webpack.dev.config.js 文件,加入一个 DllReferencePlugin 插件,并指定 vendor-manifest.json 文件
Happypack
通过多线程,缓存等方式提升 rebuild 效率 https://github.com/amireh/happypack
- 在 webpack.dev.config.js 中针对不同的资源创建多个 HappyPack, 比如 js 1 个,less 1 个,并设置好 id
- 在 module.rules 中配置 use 为 happypack/loader, 设置 id
减少 Webpack 打包后的文件体积大小
首先需要对我们整个 bundle 进行分析,由哪些东西组成及各组成部分所占大小。
这里推荐 webpack-bundle-analyzer。安装后在 webpack.dev.config.js 中添加插件即可,就能在每次启动后自动在网站打开分析结果,如下图
react bundle
除此之外,还可以将打包过程输出成json文件
然后到下面这两个网站进行分析
- webpack/analyse
- Webpack Chart
通过上面的图表分析可以清楚得看到,整个 bundle.js 的组成部分及对应的大小。
解决 bundle.js 体积过大的解决思路如下:
- 生产环境启用压缩等插件,去除不必要插件
- 拆分业务代码与第三方库及公共模块
- webpack 开启 gzip 压缩
- 按需加载
生产环境启用压缩等插件,去除不必要插件
确保在生产环境启动 webpack.DefinePlugin 和 webpack.optimize.UglifyJsPlugin。
拆分业务代码与第三方库及公共模块
由于项目的业务代码变更频率很高,而第三方库的代码变化则相对没有那么频率。如果将业务代码和第三库打包到同一个 chunk 的话,在每次构建的时候,哪怕业务代码只改了一行,即使第三方库的代码没有发生变化,会导致整个 chunk 的 hash 跟上一次不同。这不是我们想要的结果。我们想要的是,如果第三方库的代码没有变化,那在构建的时候也要保证对应的 hash 没有发生变化,从而能利用浏览器缓存,更好的提高页面加载性能和缩短页面加载时间。
因此可以将第三库的代码单独拆分成 vendor chunk,与业务代码分离。这样就算业务代码再怎么发生变化,只要第三方库代码没有发生变化,对应的 hash 就不变。
首先 entry 配置两个 app 和 vendor 两个chunk
其中 vendros.js 是自己定义的哪些第三方库需要纳入 vendor 中,如下:
然后通过 CommonsChunkPlugin 拆分第三库
上面的配置有两个细节需要注意
- 使用 chunkhash 而不用 hash
- 单独拆分 webpack 自身代码
使用 chunkhash 而不用 hash
先来看看这二者有何区别:
- hash 是 build-specific,任何一个文件的改动都会导致编译的结果不同,适用于开发阶段
- chunkhash 是 chunk-specific,是根据每个 chunk 的内容计算出的 hash,适用于生产
因此为了保证第三方库不变的情况下,对应的 vendor.js 的 hash 也要保持不变,我们再 output.filename 中采用了 chunkhash
单独拆分 webpack 自身代码
Webpack 有个已知问题:
这导致我们只是在 入口文件 改了一行代码,但编译出的 vendor 和 entry chunk 都变了,因为它们自身都包含这部分代码。
这是不合理的,因为实际上我们的第三方库的代码没变,vendor 不应该在我们业务代码变化时发生变化。
因此我们需要将 webpack 这部分代码分离抽离
其中的 name 只要不在 entry 即可,通常使用 “runtime” 或 “manifest”。
另外一个参数 minChunks 表示:在传入公共chunk(commons chunk) 之前所需要包含的最少数量的 chunks。数量必须大于等于2,或者少于等于 chunks的数量,传入 Infinity 会马上生成 公共chunk,但里面没有模块。
更多关于 CommonChunkPlugin 可以查看 官方文档
拆分公共资源
同 上面的拆分第三方库一样,拆分公共资源可以将公用的模块单独打出一个 chunk,你可以设置 minChunk 来选择是共用多少次模块才将它们抽离。配置如下:
是否需要进行这一步优化可以自行根据项目的业务复用度来判断。
开启 gzip
使用 CompressionPlugin 插件开启 gzip 即可:
按需加载
本篇不做具体介绍
参考资料
- Webpack 日常使用与优化
- 使用 Webpack 打包单页应用的正确姿势
- webpack打包分析与性能优化
- Webpack 持久化缓存实践
- 深入理解 webpack 文件打包机制