tree shaking 通过静态分析代码的引用关系,剔除未被引用的导出模块和函数,从而减小最终打包体积。它主要依赖 es module 的静态结构特性,在构建工具(如 webpack、vite)中配合 babel 或 swc 等转译器使用。只要确保代码符合纯函数规范且没有副作用,压缩器就能安全地移除死代码。

ESM 与 CommonJS 对 Tree Shaking 的影响
ESM 支持静态分析,而 CommonJS 是动态加载,因此只有 ESM 能被有效 Tree Shaking。CommonJS 的 `require` 和 `module.exports` 在运行时才确定依赖,压缩器无法提前判断哪些代码未使用。若项目混用两种模块系统,建议将库转换为 ESM 格式,或在配置中明确指定入口点。

// utils.js (ESM)
export const add = (a, b) => a + b;
export const unused = () => console.log('dead code');
// main.js
import { add } from './utils';
console.log(add(1, 2));
// 运行结果:
// 3
// 注意:unused 函数不会被打包进最终文件
副作用标记如何改变压缩行为
当代码包含全局状态修改或 API 调用时,即使函数未被直接引用,压缩器也可能保留它以防破坏程序逻辑。通过在 `package.json` 中设置 `sideEffects: false` 或数组列表,可以显式告知压缩器哪些文件无副作用,从而更激进地删除未使用模块。这能显著提升大型项目的打包效率。

// package.json
{
"name": "my-lib",
"sideEffects": ["./src/polyfill.js", "*.css"]
}
// src/index.js
import './polyfill'; // 会被保留
import { helper } from './helper'; // 若 helper 未导出且无副作用,可能被移除
// 预期结果:
// polyfill.js 始终被包含
// helper.js 仅在被 import 且无副作用时被优化
基于特定输入条件导致的意外保留现象
如果代码中存在条件导入或动态表达式,压缩器可能因无法静态确定依赖而保留更多代码。例如,使用 `if (process.env.NODE_ENV === 'production')` 时,若环境变量未正确定义,压缩器可能保守地保留所有分支。此外,某些第三方库可能故意添加副作用以兼容旧环境,导致 Tree Shaking 失效。此时需检查库的文档或手动配置排除项。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











