javascript tree shaking 在开发模式下无效,是因为该机制依赖于静态分析来移除未使用的代码,而开发环境通常为了支持热更新(hmr)和详细的错误堆栈,会保留完整的模块结构和调试信息。tree shaking 需要 webpack 等构建工具将代码压缩混淆并标记副作用,这会增加构建时间并破坏源码映射,因此默认仅在 production 模式下启用。

Webpack 配置中 mode 参数如何影响 Tree Shaking
在 Webpack 4+ 中,通过设置 mode: 'production' 可以自动启用 TerserPlugin 进行代码压缩和未使用代码的剔除。如果设置为 development,Webpack 不会执行这些优化步骤,导致未引用的函数或变量依然存在于最终的 bundle 中。

{
"entry": "./src/index.js",
"output": {
"filename": "bundle.js"
},
"mode": "production",
"optimization": {
"usedExports": true,
"minimize": true
}
}上述配置中,usedExports 标记了未使用的导出,而 minimize: true 则实际删除它们。在开发模式下,这两者通常被禁用。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
package.json 中的 sideEffects 字段为何关键
即使开启了生产模式,如果 package.json 中没有正确配置 sideEffects,Webpack 也无法安全地移除模块。该字段告诉打包器哪些文件包含副作用(如全局样式注入或全局变量修改),从而允许它放心地丢弃其他未被引用的纯函数模块。

{
"name": "my-library",
"version": "1.0.0",
"sideEffects": false
}当 sideEffects 设为 false 时,Webpack 假设所有模块都是纯函数,可以安全地进行 Tree Shaking。如果某些文件有副作用,应将其列入数组,例如 ["*.css", "src/polyfill.js"]。
为什么开发模式下保留未使用代码有助于调试
在开发环境中,保留所有代码使得开发者可以在浏览器 DevTools 中直接查看原始模块结构,便于定位错误和进行断点调试。Tree Shaking 会重命名变量和删除代码,这会使得调试过程变得困难,因为源码与运行时代码不再一一对应。

















