tree shaking 通过静态分析 es module 的导入导出关系,识别并剔除未使用的代码。它依赖于模块间无副作用的声明式依赖图,在构建时由打包工具(如 webpack 或 rollup)执行死代码消除。只要确保代码符合纯函数规范且使用标准的 esm 语法,就能自动生效。

如何配置以启用 Tree Shaking
要启用该功能,需在构建配置中指定模式为 production 或显式设置 optimization.usedExports 和 optimization.sideEffects。同时必须保证 package.json 中的 sideEffects 字段准确标记了包含副作用的文件。这样打包器才会放心地移除那些虽然被导入但从未被调用的模块。

{
"name": "my-app",
"sideEffects": false
}
在 webpack 配置中,需开启 optimization 选项。以下是一个最小化的配置示例,展示了如何通过代码明确告诉打包器哪些文件有副作用,从而允许对剩余文件进行彻底的裁剪。
立即学习“Java免费学习笔记(深入)”;
module.exports = {
mode: 'production',
optimization: {
usedExports: true,
sideEffects: true
}
};
当 sideEffects 设置为 false 时,打包器假设所有模块都是纯函数。如果某个模块导出了函数但未在入口文件中被引用,该模块将被完全忽略。若存在全局样式或脚本修改了 window 对象,则必须在 sideEffects 数组中列出这些文件,例如 ["*.css"],以防止它们被意外删除。
为什么某些代码无法被移除
如果模块在执行时会改变全局状态或产生不可逆的影响,Tree Shaking 就会失效。这是因为打包器无法确定移除该模块是否会影响程序的正常运行。常见的陷阱包括直接调用全局 API、修改原型链或在模块顶层执行复杂的初始化逻辑。此时需要手动干预或使用特定的插件来处理。

// utils.js - 有副作用
console.log('Module loaded');
window.myGlobalVar = 1;
// main.js
import './utils'; // 即使不直接使用,也必须保留
import { unusedFunc } from './utils'; // unusedFunc 不会被引入
在上述代码中,尽管 unusedFunc 未被使用,但由于 utils.js 在加载时执行了 console.log 和赋值操作,打包器必须保留整个文件。这就是所谓的“副作用”。为了优化这种情况,应将纯逻辑代码与副作用代码分离。将 pureLogic 放入另一个无副作用的模块中,即可实现对该部分的 Tree Shaking。
如何处理动态导入导致的遗漏
当使用 import() 进行动态导入时,打包器可能无法在构建阶段确定具体的依赖路径,导致部分代码被错误地剔除或未能按需加载。这通常发生在条件分支或基于变量的模块引用中。解决此问题的关键在于提供明确的提示或使用支持动态分析的插件。
// 动态导入示例 const modulePath = './' + name + '.js'; import(modulePath).then(mod => mod.init());
在这种场景下,打包器只能看到字符串拼接的结果,无法静态分析出确切的模块。为了确保必要的代码不被误删,可以使用 /* webpackInclude */ 注释来缩小搜索范围,或者在配置中指定 chunk 名称。对于复杂的动态依赖,建议重构代码,尽量使用静态导入,或者将动态部分隔离到独立的 entry chunk 中。


















