在 esbuild 中开启 tree shaking 只需将构建模式设置为生产环境，即调用 esbuild.build() 时传入 { minify: true } 或设置 --minify cli 参数。esbuild 默认在生产模式下会移除未被引用的导出函数、变量和模块，从而减小最终打包体积。这种机制依赖于 es module 的静态分析能力，确保只有实际使用的代码被保留。
开发环境与生产环境的构建设置差异
esbuild 通过 mode 选项或 minify 标志来区分开发和生产环境。在开发环境中，为了保持代码可读性和调试便利性，Tree Shaking 通常不生效，所有导入的代码都会被保留。而在生产环境中，启用 minify: true 会触发压缩和优化流程，此时 Tree Shaking 才会真正执行。开发者可以通过检查构建输出文件大小或使用 --log-level=info 来确认优化是否发生。
// build.js
const esbuild = require('esbuild');
esbuild.build({
entryPoints: ['src/index.js'],
bundle: true,
outdir: 'dist',
minify: true, // 关键配置：开启压缩并触发 Tree Shaking
treeShaking: true, // 显式开启（默认在生产模式下为 true）
}).then(() => {
console.log('Build successful with Tree Shaking');
}).catch(() => process.exit(1));
上述代码展示了如何在 Node.js 脚本中配置 esbuild。当 minify 设为 true 时，esbuild 会自动进行死代码消除。如果项目中存在未使用的导入，例如 import { unusedFunc } from './utils'，且该函数在后续代码中从未被调用，它将被从最终的 dist 包中移除。注意，treeShaking: true 是生产模式的默认行为，显式声明有助于提高代码可读性。
立即学习“Java免费学习笔记（深入）”；
ESM 与 CJS 模块格式的兼容性处理
Tree Shaking 的效果高度依赖于模块格式。esbuild 对 ES Modules (ESM) 提供完美的 Tree Shaking 支持，因为它可以静态分析导入和导出关系。然而，对于 CommonJS (CJS) 模块，由于 require() 的动态特性，esbuild 无法完全确定哪些代码是未使用的。在这种情况下，esbuild 会尝试转换 CJS 到 ESM 以进行优化，或者保守地保留所有代码。为了确保最佳的 Tree Shaking 效果，建议项目内部统一使用 ESM 格式，或在入口点明确使用 .mjs 扩展名。
// utils.mjs (ESM)
export function used() { return 'used'; }
export function unused() { return 'unused'; }
// index.mjs (ESM)
import { used } from './utils.mjs';
console.log(used());
// 运行命令: esbuild index.mjs --bundle --minify --outfile=out.js
// 结果: out.js 中仅包含 used 函数的逻辑，unused 被移除
在上面的示例中，index.mjs 只导入了 used 函数。当使用 esbuild 进行生产构建时，unused 函数及其相关代码会被彻底移除。如果将 utils.mjs 改为 utils.cjs 并使用 module.exports，esbuild 可能无法精确剔除 unused，导致打包体积略大。因此，保持模块系统的统一性是发挥 Tree Shaking 优势的关键。
条件导出与副作用标记的影响
当项目依赖第三方库时，Tree Shaking 的效果还受到库自身配置的影响。许多现代 npm 包会在 package.json 中使用 sideEffects 字段来标记哪些文件具有副作用（如修改全局变量或注册事件监听器）。如果文件被标记为无副作用，esbuild 可以更激进地移除未使用的导入。反之，如果文件有副作用，即使未直接调用其导出函数，esbuild 也可能保留该文件以确保程序正常运行。开发者应检查依赖包的 sideEffects 配置，并在必要时手动调整或联系维护者更新。
