配置 javascript tree shaking 体积告警,核心在于结合 webpack 的 sideeffects 属性与 webpack-bundle-analyzer 插件。通过标记无副作用的文件并分析打包后的模块占比,可以精准定位未使用的代码并触发构建警告。

如何配置 sideEffects 以启用 Tree Shaking
在 package.json 中设置 sideEffects 字段是启用 Tree Shaking 的前提。Webpack 依赖此信息来判断哪些文件可以被安全地移除。如果项目中的 CSS 或某些全局脚本有副作用,必须显式列出它们,否则会被错误地剔除。

{
"name": "my-app",
"version": "1.0.0",
"sideEffects": [
"*.css",
"src/polyfill.js"
]
}
上述配置告诉 Webpack,所有 .css 文件和 src/polyfill.js 具有副作用,不应被删除。其余未被引用的模块在 Production 模式下将被自动移除。确保 mode 设置为 production 或手动开启 optimization.usedExports 和 optimization.minimize。
如何集成 webpack-bundle-analyzer 监控体积
安装 webpack-bundle-analyzer 并将其添加到 plugins 数组中,可以在构建完成后生成可视化的体积报告。这有助于识别哪些模块占据了大部分空间,从而判断 Tree Shaking 是否生效。
在代码库出现结构漂移之前,扫描JS或TS代码库中的禁止导入、循环依赖、孤立模块和其他依赖规则违规情况。

const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin;
module.exports = {
mode: 'production',
optimization: {
usedExports: true,
minimize: true
},
plugins: [
new BundleAnalyzerPlugin({
analyzerMode: 'static',
openAnalyzer: false
})
]
};
运行构建命令后,会生成 stats.html 文件。打开该文件即可看到各模块的体积占比。若发现大量未使用的代码仍被包含,需检查 sideEffects 配置是否正确,或确认导入路径是否使用了 ES Module 语法。
当引入第三方库时 Tree Shaking 为何失效
许多第三方库虽然支持 Tree Shaking,但其 package.json 中可能未正确配置 sideEffects,或者导出的是 CommonJS 格式而非 ES Module。此时,Webpack 无法确定哪些导出是安全的,从而保留整个库。
解决此问题的一种方法是使用 resolve.alias 指向库的 ES Module 版本,例如 lodash-es 替代 lodash。另一种方法是在 sideEffects 中排除特定库,但这需要谨慎操作,避免误删必要代码。若库本身不支持,只能考虑替换为更轻量的替代品或使用按需加载策略。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










