封装工具函数以实现 tree shaking 的核心做法是确保使用 es module (esm) 语法导出,保持函数为纯函数且不产生副作用,并避免在模块顶层执行不可逆的逻辑。通过这种方式打包工具时,未引用的代码会被构建工具(如 webpack、vite)自动剔除,从而减小最终产物体积。

如何编写无副作用的纯函数
实现无副作用的关键在于函数不修改外部状态,也不依赖外部可变状态。只要函数只根据输入参数计算返回值,构建工具就能安全地将其标记为可摇树。
export function capitalize(str) {
if (typeof str !== 'string') return '';
return str.charAt(0).toUpperCase() + str.slice(1);
}
上述 capitalize 函数完全符合纯函数定义。它接收字符串,返回新字符串,没有读写全局变量或 DOM。当开发者仅导入并使用该函数时,打包工具可以确信删除其他未使用的导出不会影响程序运行。
如何处理带有副作用的工具函数
如果工具函数需要执行副作用(如注册事件监听器、修改原型链),必须明确告知构建工具这些代码不能被移除。通常的做法是将副作用逻辑与纯逻辑分离,或者使用特定的注释标记。
// utils/sideEffect.js
import './polyfill'; // 假设这里引入了一个会修改 Array.prototype 的文件
export function sortArray(arr) {
return [...arr].sort();
}
在这个例子中,sortArray 本身是纯函数,但引入的 ./polyfill 包含副作用。如果直接导入 sortArray,构建工具可能会因为担心 polyfill 被误删而保留整个文件。最佳实践是将副作用隔离在单独的入口文件中,或者在纯函数所在的模块中避免顶层执行语句。
基于特定输入条件的具体处理
在处理包含条件分支的工具函数时,如果某些分支依赖于运行时才能确定的配置,可能会导致 Tree Shaking 失效。例如,如果工具函数内部根据环境变量动态决定导出内容,构建工具可能无法静态分析出哪些导出是死代码。
const isDev = process.env.NODE_ENV === 'development';
export function log(msg) {
if (isDev) {
console.log(msg);
}
}
虽然这段代码看起来简单,但如果 process.env.NODE_ENV 没有被构建工具正确替换为字面量,Tree Shaking 的效果会大打折扣。确保构建配置中正确定义了 DefinePlugin 或等效的环境变量替换机制,能让 log 函数在非开发环境下被彻底优化掉。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











