要让 javascript tree shaking 生效,必须将代码打包为 es module (esm) 格式,并确保模块内只包含纯函数且没有副作用。具体做法是将逻辑封装在独立的 .js 文件中,使用 export 导出函数,并在入口文件通过 import 按需引入。只要构建工具(如 webpack、vite)配置正确,未被引用的导出函数就会被自动移除。

如何定义一个可被安全移除的纯函数模块
定义纯函数模块的核心在于消除副作用并明确依赖边界。纯函数是指相同的输入永远产生相同的输出,且不修改外部状态或执行 I/O 操作。在实现时,应将每个功能点拆分为独立的小函数,避免在模块顶层执行任何非声明式的代码。这样,当构建工具分析引用关系时,能准确识别出哪些函数是“死代码”。

// utils/math.js - 纯函数模块示例
// 注意:这里没有顶层执行逻辑,只有函数定义
export function add(a, b) {
return a + b;
}
export function subtract(a, b) {
return a - b;
}
export function multiply(a, b) {
return a * b;
}
在上述代码中,add、subtract 和 multiply 都是纯函数。如果主程序只导入了 add,那么 subtract 和 multiply 就不会出现在最终的打包产物中。关键在于不要在这些函数之外添加初始化代码或全局变量赋值。
为什么 CommonJS 会导致 Tree Shaking 失效
CommonJS (CJS) 模块系统采用动态加载机制,其 require() 调用可以在运行时任意位置执行,甚至根据条件决定加载哪个模块。这种动态性使得静态分析工具难以在编译阶段确定模块的确切依赖关系,因此无法安全地移除未使用的代码。相比之下,ESM 的 import 语句必须在模块作用域的顶层,且是静态解析的,这为 Tree Shaking 提供了必要的确定性。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

// bad: commonjs/index.js
const math = require('./math');
console.log(math.add(1, 2));
// good: esm/index.js
import { add } from './utils/math.js';
console.log(add(1, 2));
在 ESM 示例中,构建工具可以清晰地看到只有 add 被使用。而在 CJS 示例中,即使只用了 add,整个 ./math 模块的内容都可能被保留,因为工具无法确定 require 是否会返回其他属性或在运行时发生变异。将项目迁移到 ESM 是启用 Tree Shaking 的前提条件。
模块顶层存在副作用时会发生什么
如果模块顶层包含直接执行的代码(如修改原型链、注册事件监听器或打印日志),该模块会被视为具有“副作用”。此时,即使你从未导入其中的任何函数,构建工具也会强制引入整个模块,以确保这些副作用在应用启动时得以执行。这会导致 Tree Shaking 失败,因为模块本身被视为必需项,其内部所有导出内容都会被保留。
// side-effect.js - 具有副作用的模块
console.log('Module loaded'); // 副作用:执行打印
Array.prototype.unique = function() { ... }; // 副作用:修改原型
export function helper() {
return 'helper';
}
在上述 side-effect.js 中,由于顶层有 console.log 和原型修改,即使主程序只想要 helper 函数,Webpack 或 Vite 也会将整个文件打包进去。要解决此问题,应将副作用隔离到专门的入口文件或垫片文件中,或者重构代码以消除顶层执行逻辑,确保模块仅作为纯函数的容器。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










