tree shaking 通过构建时静态剔除未引用代码减少包体积,需使用 es 模块、配置 sideeffects、避免破坏静态分析的写法,并通过工具验证效果。

Tree Shaking 能直接减少打包产物体积,从而降低网络传输开销。它的核心不是运行时优化,而是在构建阶段静态剔除未被引用的代码,让浏览器只需下载真正需要的部分。
确保使用 ES 模块语法
Tree Shaking 依赖静态可分析的模块结构。CommonJS(require/module.exports)在运行时才确定依赖,无法被可靠识别;必须统一使用 import/export 语法。
- 第三方库若提供 ESM 版本(如
lodash-es),优先替换lodash - 自定义模块避免混合写法:不要在同一个文件中混用
import和require - 检查库的
package.json是否包含"module"字段,这是 ESM 入口标识
配置 sideEffects 标记
告诉打包工具哪些文件“没有副作用”,可以安全删除。默认情况下,工具会保守保留所有导入,即使没用到导出内容。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 在项目根目录
package.json中添加:"sideEffects": false(适用于全项目无副作用) - 若某些文件有副作用(如全局样式、polyfill 注入),用数组显式声明:
"sideEffects": ["*.css", "src/polyfills.js"] - Vite 和 Webpack 都依赖该字段触发深度摇树,漏配会导致大量代码残留
避免破坏摇树的常见写法
一些看似无害的代码模式会让打包工具放弃摇树,误判为“可能被用到”。
- 不要解构导入后又整体导入:
import { debounce } from 'lodash-es'; import _ from 'lodash-es';—— 后者会引入全部 - 避免动态导入路径:
import(`./components/${name}.js`)无法静态分析,应改用明确的import()或预定义映射 - 导出对象时慎用计算属性或赋值语句:
export const utils = { [key]: fn }可能阻断识别
验证是否生效
不能只看 bundle 大小变化,要确认删的是真·死代码。
- Webpack 用户可启用
stats: "verbose",查看unusedExports日志 - Vite 项目配合
vite-plugin-visualizer生成依赖图谱,直观定位未被引用的模块 - 手动测试:删掉某个函数调用后,检查它是否仍出现在最终 chunk 的源码中
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










