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 是否生效的方法
别光信配置,得验证结果。常用手段:
立即学习“Java免费学习笔记(深入)”;
- 用 Webpack 的 stats: 'verbose' 或插件(如 webpack-bundle-analyzer)查看最终打包产物中有没有你没引用的模块或函数
- Vite 项目可在 build 后打开 dist/assets/xxx.js,搜索某个未使用的函数名,看是否还在
- 在源码里加个明显但未调用的函数(如 export function unused() { alert('dead') }),然后构建后检查它是否消失
- 注意:开发模式通常不启用 Tree Shaking(为调试友好),一定要用 production 模式构建 再验证
基本上就这些。Tree Shaking 不复杂但容易忽略细节,重点是写法规范 + 配置配合 + 主动验证。











