Webpack 实践技巧与建议 翻译自 webpack-tricks ,从属于笔者的 Web Frontend Introduction And Best Practices:前端入门与最佳实践 。如果想了解更多的编程技术体系概况可以参考 2016:我的技术体系结构图 ,如果想及时了解一周优秀外文资料可以参考 某熊周刊系列:一周推荐外文技术资料(12.1) 。
本文是笔者在使用Webpack的过程中总结的一系列建议与技巧,不过需要注意的是这些小技巧都是关于Webpack 1的。Webpack 2与Webpack 1相比其API发生了较大变化,本文提及的不少技巧可能在Webpack 2并不能起作用。如果你想了解从Webpack 1迁移到Webpack 2的详细教程,可以参考 这里 ,另外可以参考笔者的基于Webpack 2的模板 Webpack2-React-Redux-Boilerplate 。
可以在使用Webpack的时候添加如下选项:
--progress --colors
可以在进行生产环境构建时添加 -p
选项:
webpack -p
在设置output的文件名时可以使用 [name].js
多匹配名,如下的例子会生成 a.js
与 b.js
:
module.exports = { entry: { a: './a', b: './b' }, output: { filename: '[name].js' } }
如果你担心代码重复的问题,可以使用 CommonsChunkPlugin 来抽取出多个输出文件的公共代码:
plugins: [ new webpack.optimize.CommonsChunkPlugin('init.js') ] <script src='init.js'></script> <script src='a.js'></script>
同样是使用CommonsChunkPlugin来讲公共的渲染代码移动到 vendor.js
中:
var webpack = require('webpack') module.exports = { entry: { app: './app.js', vendor: ['jquery', 'underscore', ...] }, output: { filename: '[name].js' }, plugins: [ new webpack.optimize.CommonsChunkPlugin('vendor') ] }
其工作流程如下,具体可以参考 Code Splitting :
添加 vendor
入口并且指定关联库
CommonsChunkPlugin会从 app.js
中移除相关库
CommonsChunkPlugin 同样会把Webpack的运行时依赖迁移到 vendor.js
中
目前最流行的Source Maps选项是 cheap-module-eval-source-map
,这个工具会帮助开发环境下在Chrome/Firefox中显示源代码文件,其速度快于 source-map
与 eval-source-map
:
const DEBUG = process.env.NODE_ENV !== 'production' module.exports = { debug: DEBUG ? true : false, devtool: DEBUG ? 'cheap-module-eval-source-map' : 'hidden-source-map' }
在Chrome Devtools你可以在 webpack:///foo.js?a93h
路径下查看文件,也可以选择自定义配置:
output: { devtoolModuleFilenameTemplate: 'webpack:///[absolute-resource-path]' }
作者正在编辑中,请过几日回来查看。
如果你希望在仅仅在开发模式下开启某些选项:
const DEBUG = process.env.NODE_ENV !== 'production' module.exports = { debug: DEBUG ? true : false, devtool: DEBUG ? 'cheap-module-eval-source-map' : 'hidden-source-map' }
这个时候你需要注意在编译生产环境版本时使用如下命令: env NODE_ENV=production webpack -p
如果你觉得你的包体有点匪夷所思的大并且想具体了解到底是哪个模块占据了大量的提及,可以使用 webpack-bundle-size-analyzer :
$ yarn global add webpack-bundle-size-analyzer $ ./node_modules/.bin/webpack --json | webpack-bundle-size-analyzer jquery: 260.93 KB (37.1%) moment: 137.34 KB (19.5%) parsleyjs: 87.88 KB (12.5%) bootstrap-sass: 68.07 KB (9.68%) ...
React在开发模式下会自带开发工具,而我们希望在生产环境下能够移除该工具从而减少包体,我们可以通过如下配置:
plugins: [ new webpack.DefinePlugin({ 'process.env': { 'NODE_ENV': JSON.stringify(process.env.NODE_ENV || 'development') } }) ]
Lodash 是非常不错的工具库,不过很多时候我们仅需要其一小部分功能,此时 lodash-webpack-plugin 就派上了用场:
const LodashModuleReplacementPlugin = require('lodash-webpack-plugin'); const config = { plugins: [ new LodashModuleReplacementPlugin({ path: true, flattening: true }) ] };
如果你希望达到如下的效果:
require('./behaviors/*') /* Doesn't work! */
你需要使用 require.context
:
// http://stackoverflow.com/a/30652110/873870 function requireAll (r) { r.keys().forEach(r) } requireAll(require.context('./behaviors/', true, //.js$/))s