tree shaking 能起作用的核心在于 es modules 的静态结构特性——import/export 必须顶层声明、不可动态或条件化，使打包工具可在编译期构建精确依赖图，从而安全剔除未引用的具名导出；commonjs、动态 import()、默认导出大对象、顶层副作用代码均会破坏该机制。

Tree Shaking 能起作用，核心在于 ES Modules（ESM）的静态结构特性——所有 import 和 export 必须写在顶层、不能条件化、不能动态拼接。打包工具（如 Webpack、Rollup、Vite）正是靠这种“可预测性”，在编译阶段就画出完整的依赖图，从而准确识别哪些导出从未被引用，进而剔除。

必须用 ESM 语法，禁用 CommonJS 和动态导入

CommonJS 的 require 和 module.exports 是运行时行为，无法静态分析；动态 import() 同样属于运行时加载，会切断静态依赖链。

• ✅ 正确：静态具名导入导出
• import { debounce } from './utils.js';
• export function debounce(fn, wait) { ... }
• ❌ 错误：CommonJS 混用
• const { debounce } = require('./utils'); → Tree Shaking 失效
• ❌ 错误：动态导入或条件导出
• if (env === 'prod') import('./feature.js'); → 静态分析中断

导出方式要颗粒化，避免默认导出大对象

如果把多个工具函数塞进一个默认导出的对象里，比如 export default { debounce, throttle, deepClone }，打包器无法判断其中哪个属性被用了——整个对象会被当作一个整体保留。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• ✅ 推荐：每个函数单独具名导出
• export function debounce(...) { ... }
• export function throttle(...) { ... }
• ✅ 入口文件可做“巴氏分发”
• export { debounce } from './debounce.js';
• export { throttle } from './throttle.js';
• ❌ 避免：默认导出 + 解构使用
• import Utils from './utils'; console.log(Utils.debounce); → 整个 Utils 对象保留在包中

确保代码无副作用，显式声明 sideEffects

即使语法是 ESM，如果模块顶层有副作用（如修改全局变量、调用 console.log、注册事件），打包器会保守保留整个模块，以防误删影响运行逻辑。

• ✅ 安全写法：纯函数、无顶层执行语句
• export function add(a, b) { return a + b; }
• ✅ 若必须有副作用，通过 package.json 显式声明
• "sideEffects": ["*.css", "*.scss"] → 表示只对 CSS 文件有副作用，JS 文件可安全摇树
• "sideEffects": false → 表示全部模块无副作用，大胆摇
• ❌ 危险写法：模块顶层直接执行
• console.log('utils loaded'); 或 window.myLib = {}; → 模块不会被剔除

构建配置需启用生产模式与标记功能

即使代码完全合规，工具默认也不会开启 Tree Shaking。Webpack 需要明确进入生产模式，并启用导出标记。

• Webpack 中关键配置项
• mode: 'production'（自动启用 usedExports 和压缩）
• 或手动配置：optimization: { usedExports: true, minimize: true }
• Rollup 默认开启，但需确认 treeshake: true（新版默认启用）
• Vite 基于 Rollup，开箱即用，无需额外配置

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南