什么是javascriptTreeShaking_打包时如何删除死代码？

2025-12-15 00:00:00 作者：夢幻星辰

JavaScript Tree Shaking 是通过静态分析 ES 模块 import/export 依赖图，在打包时移除未使用代码的优化技术，要求使用 ES 模块、支持该特性的打包工具（如 Webpack 4+、Vite、Rollup）、无副作用代码，并需配置 "sideEffects" 字段及规范导出方式，最后必须在 production 模式下构建并验证生效。

JavaScript Tree Shaking 是一种在打包阶段自动识别并移除未使用代码（即“死代码”）的优化技术，主要依赖 ES 模块的静态结构特性实现。它不是靠运行时分析，而是靠编译时对 import/export 的依赖图进行静态分析，把确定用不到的导出和模块整个剔除。

Tree Shaking 起作用的前提条件

它只对 ES 模块（export / import）有效，CommonJS（require / module.exports）无法被摇掉，因为后者是动态的、运行时才决定依赖关系。

项目必须使用 ES 模块语法（不能混用 require）
打包工具需支持 Tree Shaking（如 Webpack 4+、Vite、Rollup 默认开启）
代码不能有副作用干扰判断（比如模块顶层写了直接执行的函数、修改全局变量等）
确保 "sideEffects": false 或精确列出有副作用的文件（写在 package.json 中）

如何让自己的代码可被 Tree Shaken

即使用了 ES 模块，如果写法不“干净”，工具也可能保守保留代码。关键点在于导出和调用方式要明确、静态可分析。

避免默认导出一个对象再解构使用（例如 import { foo } from './utils.js' 比 import utils from './utils.js'; utils.foo() 更容易被摇掉）
不要在 export 前做有副作用的操作（比如 console.log('init') 放在 export 外面，会被视为有副作用而保留整个模块）
工具库建议提供具名导出（named exports），而不是只给一个 default 对象
函数尽量保持纯（无副作用、不改外部状态），便于工具推断其可删除性

检查 Tree Shaking 是否生效的方法

别光信配置，得验证结果。常用手段：

用 Webpack 的 stats: 'verbose' 或插件（如 webpack-bundle-analyzer）查看最终打包产物中有没有你没引用的模块或函数
Vite 项目可在 build 后打开 dist/assets/xxx.js，搜索某个未使用的函数名，看是否还在
在源码里加个明显但未调用的函数（如 export function unused() { alert('dead') }），然后构建后检查它是否消失
注意：开发模式通常不启用 Tree Shaking（为调试友好），一定要用 production 模式构建 再验证

基本上就这些。Tree Shaking 不复杂但容易忽略细节，重点是写法规范 + 配置配合 + 主动验证。