Tree Shaking 是打包阶段静态分析 ES Module 的 import/export,仅移除未被引用的具名导出;对 default export、CommonJS、动态语法及有副作用代码无效,需配合 ESM 格式与正确配置。
Tree Shaking 不是运行时机制,也不是智能
AI 删除逻辑,它只在打包阶段(如 Webpack、Rollup、Vite)静态分析 import / export 语句,把**未被引用的具名导出(named export)** 标记为可移除。它对 default export 或 CommonJS 式的 module.exports 基本无效,因为后者无法在不执行代码的前提下判断导出是否被使用。
关键前提是:模块必须是 ES Module(.js 文件中用 export 和 import),且打包工具开启相应优化(如 Webpack 的 mode: 'production' + optimization.usedExports: true)。
eval()、with、try/catch 等动态语法,整个模块会被标记为有副作用,跳过 shakingexport const unused = 123,只要没被任何 import { unused } 引用,它大概率会被剔除因为主流 CDN 或 npm 上的 lodash 默认导出的是一个 CommonJS 包,其 index.js 内部用 module.exports = { debounce, throttle, ... } 组装对象 —— 打包工具无法静态确认你只用了其中某个属性,只能全量保留。
解决办法不是靠 Tree Shaking,而是改用支持 ESM 的子路径导入:
import debounce from 'lodash/debounce';
// 或
import { debounce } from 'lodash-es';lodash-es 是官方维护的 ES Module 版本,每个函数单独导出,配合 import 语句才能被正确 shake;而 lodash/debounce 路径在 Webpack 5+ 中也能触发模块级 tree shaking(前提是该入口本身是 ESM)。
import _ from 'lodash' —— 这会引入全部方法和依赖node_modules/lodash-es/package.json 是否有 "type": "module" 或 "exports" 字段,确保工具识别为 ESMlodash-es shaking;Webpack 需确认已启用 experiments.topLevelAwait 和 optimization.concatenateModules
看似无关的代码,可能让整个模块“变胖”。常见失效点集中在副作用(side effects)判定上:
console.log('init')、localStorage.setItem('flag', '1') —— 工具认为它有副作用,不敢删export default class X { constructor() { this.x = 1; } } 即使没被 new,也可能因潜在实例化行为被保留export const utils = { foo() {}, bar() {} } —— 整个 utils 对象无法被部分 shake/*#__PURE__*/ 注释但位置错误(必须紧贴函数调用前,如 /*#__PURE__*/foo())若确定某模块无副作用,可在 package.json 中显式声明:
"sideEffects": false
或更精确地列出有副作用的文件:"sideEffects": ["*.css", "src/init.js"]。
Tree Shaking 只解决“没用的导出”,真正减体积要组合多种策略:
terser-webpack-plugin(Webpack)或默认压缩(Vite/Rollup)—— 删除空格、缩短变量名、折叠常量splitChunks 抽离公共模块(如 react、lodash-es),避免重复打包dynamic import() 实现路由/组件级懒加载,让 chunk 按需下载source-map 是否误打包进生产产物(确保 devtool: false 或 'source-map' 仅用于本地)webpack-bundle-analyzer 查看哪些模块占比异常高,再针对性处理(比如替换成更轻量的替代库)最常被忽略的一点:node_modules 中的 devDependencies 如果意外打进生产包(比如误在 dependencies 里装了 @types/react),也会显著增大体积 —— 检查 package.json 的依赖分类是否合理。