tree shaking 生效需模块为 es 模块且无副作用；副作用会导致死代码残留，可通过构建工具诊断、检查 sideeffects 字段、避免全局修改等手段识别和规避。
Tree Shaking 能生效的前提是：模块必须是 ES 模块（import/export），且代码没有可观察的副作用。一旦 JavaScript 引擎或打包工具（如 Webpack、Rollup、Vite）认为某段代码可能产生副作用，它就会保守地保留该代码，哪怕你没显式调用它——这就导致本该被摇掉的死代码“污染”了整个 Tree Shaking 过程。
怎么检查副作用是否被误判？
最直接的方式是查看最终打包产物（如 dist/ 下的 bundle 文件），结合 source map 定位未被移除但本应删除的代码。更高效的做法是利用构建工具的诊断能力：
-
Webpack：开启
optimization.providedExports和optimization.usedExports，再配合stats: "verbose"或使用 webpack-bundle-analyzer 查看哪些 export 被标记为 “used” 或 “unused”；若某模块所有导出都标为 unused 却仍被打包进来，大概率是副作用触发了全量保留。 -
Rollup / Vite（底层 Rollup）：启用
treeshake: { moduleSideEffects: false }并配合onwarn钩子捕获 “Treeshaking unknown side effect in…” 类警告，这些就是工具无法静态分析、默认视为有副作用的语句（如 try/catch、with、eval、全局赋值等）。 -
查看 package.json 的 "sideEffects" 字段：如果依赖包声明了
"sideEffects": false，表示整个包无副作用，可安全摇；若为数组（如["*.css", "index.js"]），则只对列表外的文件启用摇；若缺失或为true，工具会默认整个包有副作用，跳过摇 —— 这是第三方库污染你项目的常见源头。
哪些写法会意外引入副作用？
不是只有 API 调用才算副作用。以下看似无害的操作，都会让工具放弃摇掉相关模块：
-
对全局对象的修改：例如
window.myLib = {...}、Array.prototype.myMethod = ...、console.log("init")（即使在模块顶层）。 -
import 但不使用：比如
import './polyfill.js'或import 'lodash-es'（后者因内部有顶层 this 判断等逻辑，默认被判定有副作用）。 -
动态 import() + 字符串拼接：如
import(`./mod-${type}.js`)，无法静态分析导入目标，整块逻辑会被保留。 - try/catch 中的 import 或变量声明：控制流不可预测，工具无法保证 catch 块是否执行，倾向保留全部。
-
带有 getter/setter 的 export 对象：如
export const obj = { get x() { return Math.random(); } }，访问属性可能有副作用，工具不敢摇。
如何主动避开副作用污染？
核心原则：让模块“纯”起来，明确告诉打包器“这里没副作用”。
-
把副作用逻辑抽离到单独入口：例如 polyfill、样式注入、全局监听器，统一放在
main.ts或entry-client.ts中显式导入，其他业务模块保持 pure export。 -
用 /*#__PURE__*/ 标记无副作用调用：如
/*#__PURE__*/ console.log("debug")，Webpack 5+ 和 Rollup 会识别并允许摇掉该语句（生产环境自动移除）。 -
避免顶层副作用语句：把
localStorage.setItem、new Worker()等移到函数内，仅在真正需要时执行。 -
为自己的库正确配置 "sideEffects"：在
package.json中写明哪些文件有副作用（如["*.css", "dist/*.d.ts"]），其余设为false；或者确保所有导出都是 pure 函数/常量。 -
慎用第三方库的默认导入：改用具名导入（
import { debounce } from 'lodash-es'），避免import _ from 'lodash-es'（后者含大量副作用逻辑）；必要时搭配 babel-plugin-lodash 自动转换。
验证是否成功：一个最小闭环
写一个测试模块：src/utils/math.ts：
export const add = (a, b) => a + b;<br>export const PI = 3.14159;<br>console.log('math init'); // ← 这行会让整个模块无法被摇
在主文件中只 import add：
import { add } from './utils/math';<br>console.log(add(1, 2));
然后构建并搜索 dist 中是否还存在
math init 或 PI 字符串。如果存在，说明副作用未清除；删掉 console.log 再试，应完全消失。Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
