tree shaking 通过静态分析 es module 的导入导出关系来检测未使用的导出。具体做法是确保代码使用标准的 import 和 export 语法,并在打包工具(如 webpack、vite)中开启生产模式或配置 sideeffects: false。这样构建工具在生成最终包时,会自动剔除未被任何入口文件引用的导出函数、变量或类。

如何配置打包工具以启用 Tree Shaking?
配置的核心在于告知打包工具哪些模块没有副作用,并正确设置环境为生产模式。以 Webpack 为例,需要在 package.json 中声明 "sideEffects": false,或者在 webpack.config.js 中显式配置该选项。同时,必须使用 production 模式或设置 mode: 'production',因为开发模式下通常为了调试会保留所有代码。对于 Vite,由于其基于 Rollup,默认在生产构建时就启用了 Tree Shaking,只需确保使用 ESM 格式即可。

{
"name": "my-library",
"version": "1.0.0",
"sideEffects": false,
"main": "dist/index.cjs.js",
"module": "dist/index.esm.js"
}
上述 package.json 配置告诉打包器当前包内的 JS 文件均无副作用(如修改全局变量),因此可以安全地进行裁剪。配合 module 字段指向 ESM 入口,能确保打包工具读取到正确的静态结构进行分析。
立即学习“Java免费学习笔记(深入)”;
为什么某些代码即使未使用也无法被移除?
无法被移除通常是因为打包工具无法确定代码是否存在副作用,或者使用了非标准的动态引用方式。如果代码调用了全局 API、修改了原型链或引入了带有副作用的文件,打包工具出于安全考虑会保留这些代码。此外,如果使用 CommonJS 的 require() 或动态字符串拼接进行导入,由于缺乏静态分析的依据,Tree Shaking 也会失效。解决思路是将可能产生副作用的代码隔离出来,或在配置中明确排除它们。

// utils.js
export function pureFunc() { return 1; }
export function sideEffectFunc() { console.log('init'); }
// index.js
import { pureFunc } from './utils';
pureFunc();
在上面的示例中,如果 package.json 设置了 sideEffects: false,sideEffectFunc 会被移除,导致应用初始化失败。正确的做法是在 package.json 中将 sideEffects 设置为数组,指定包含副作用的文件:"sideEffects": ["./src/utils.js"],这样打包工具就会保留该文件中的所有内容。
如何验证某个导出是否真的被移除了?
验证最直接的方法是查看构建后的输出文件或使用可视化工具。可以通过运行构建命令后,检查生成的 .js 文件中是否还包含未使用的函数名。更精确的方法是使用 webpack-bundle-analyzer 插件,它会将打包结果生成为交互式图表,清晰地展示每个模块的大小及其来源。如果某个导出在图中完全不可见,或者其体积为零,则说明它已被成功移除。另外,也可以尝试故意引入一个不存在的导出,如果构建报错,说明导入机制正常;如果构建成功但运行时找不到,则可能是被误删或路径错误。


















