Tree-shaking 是一种基于 ES6 模块静态分析的构建优化技术，通过标记未引用的导出并结合压缩工具移除死代码，需使用 ESM 语法、支持的构建工具及正确配置 sideEffects 才能生效。
Tree-shaking 并不是 JavaScript 本身的特性，而是一种在构建阶段通过静态分析模块依赖来消除无用代码的优化技术。它广泛应用于现代前端工程化工具中，如 Webpack、Rollup 和 Vite，目标是减少最终打包文件的体积，提升应用性能。
Tree-shaking 是如何工作的？
Tree-shaking 的核心原理基于 ES6 模块（ESM）的静态结构。与 CommonJS 的动态 require 不同，ES6 模块的导入导出在编译时就能确定，这使得构建工具可以在不执行代码的情况下分析哪些模块或函数被实际使用。
基本流程如下：
- 构建工具从入口文件开始，递归分析所有通过 import 引入的模块
- 标记所有被引用的导出（export）
- 未被引用的导出被视为“死代码”
- 结合 Uglify 或 Terser 等压缩工具，在压缩阶段真正移除这些未使用的代码
举个例子：
立即学习“Java免费学习笔记（深入）”；
// utils.js
export const add = (a, b) => a + b;
export const subtract = (a, b) => a - b;
<p>// main.js
import { add } from './utils';
console.log(add(1, 2));
在这个例子中，subtract 函数虽然被导出，但没有被任何模块引入。构建工具会将其标记为可剔除代码，在生产打包时排除。
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
实现 Tree-shaking 的前提条件
要让 tree-shaking 正常工作，必须满足几个关键条件：
- 使用 ES6 模块语法：只有 import / export 能被静态分析，CommonJS（require / module.exports）无法被可靠地 shake 掉
- 构建工具支持：Webpack 4+、Rollup、Vite 等默认开启 tree-shaking，但需要正确配置 mode 为 production
- 副作用（sideEffects）配置：如果一个模块执行时有副作用（比如注册全局组件、修改原型链），需要在 package.json 中声明 "sideEffects": true 或列出具体有副作用的文件，否则构建工具可能错误地移除它们
例如：
// package.json
{
"name": "my-lib",
"sideEffects": [
"./src/polyfill.js",
"./src/theme.css"
]
}
这样配置后，即使某些文件没有显式导出，也会被保留。
常见误区和注意事项
很多人以为只要用了 ES6 模块，tree-shaking 就自动生效，其实不然。以下是一些容易忽略的问题：
- 动态导入无法 shake：使用 import() 动态加载的模块不会参与静态分析
- 赋值给变量的导入会被保留：比如 import * as utils from './utils'，即使只用了一个方法，整个模块也可能被保留
- 第三方库需支持 ESM：如果引入的 npm 包只提供 CommonJS 版本，tree-shaking 对其无效
- 开发环境默认不启用：tree-shaking 主要在 production 模式下生效，开发模式为了调试通常保留全部代码
如何验证 Tree-shaking 是否生效？
可以通过以下方式确认：
- 使用 Webpack Bundle Analyzer 查看打包产物，检查是否包含未使用的函数
- 在代码中添加明显的“无用导出”，观察生产构建后是否被剔除
- 查看压缩后的代码，确认 dead code 消失
基本上就这些。Tree-shaking 是现代前端工程化的基础优化手段，理解其原理有助于写出更友好的可摇树代码，也能避免因配置不当导致的意外问题。
