在 javascript 项目中，通过配置 package.json 中的 exports 字段并配合 sideeffects 数组，可以精确控制 tree shaking 的生效范围。具体做法是在 exports 中为不同入口（如 import 和 require）分别指定包含 sideeffects: false 的构建产物路径，这样打包工具就能安全地移除未使用的代码。
如何配置 exports 以支持 ESM 和 CJS 两种导入方式
要同时支持现代构建工具和旧版 Node.js，需要在 exports 中使用通配符映射。针对 import 语句，指向经过压缩且标记为无副作用的 ESM 文件；针对 require 调用，指向对应的 CJS 文件。这种双轨制配置确保了无论开发者使用哪种语法，Tree Shaking 都能正确识别并优化依赖。
{
"name": "my-lib",
"version": "1.0.0",
"sideEffects": false,
"exports": {
".": {
"import": "./dist/index.mjs",
"require": "./dist/index.cjs"
}
}
}
上述配置中，"." 代表包根目录。当用户执行 import { foo } from 'my-lib' 时，打包工具会解析到 ./dist/index.mjs。如果该文件内部没有声明副作用，且顶层 sideEffects 为 false，未引用的导出将被剔除。若需对特定文件例外处理，可将 sideEffects 改为数组，列出如 ["./src/polyfill.js"] 的文件。
立即学习“Java免费学习笔记（深入）”；
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
为什么 sideEffects 标记能提升打包体积优化效果
sideEffects 是告诉打包器哪些模块具有全局影响的关键标识。如果标记为 false，意味着该模块内的代码仅通过导入/导出交互，不会修改全局状态或产生其他外部可见的行为。这使得打包器可以大胆地删除未被直接引用的导出函数或变量，从而显著减小最终 bundle 的大小。
// src/utils.js
export function pureAdd(a, b) { return a + b; }
export function impureLog() { console.log('init'); }
// package.json
{
"sideEffects": ["./src/utils.js"]
}
在上面的例子中，即使 pureAdd 未被使用，由于 utils.js 被列在 sideEffects 数组中，打包器无法确定删除 pureAdd 是否会影响 impureLog 的执行顺序或结果，因此会保留整个文件。只有将 sideEffects 设为 false 或从数组中移除该文件，Tree Shaking 才能精准剥离无用代码。
当 exports 指向的模块本身包含副作用时会发生什么
如果 exports 指向的构建产物中包含全局样式注入、API 劫持或全局变量修改等副作用，Tree Shaking 机制会自动失效或变得保守。此时，即使你只导入了一个纯函数，打包器也会因为检测到副作用而保留整个模块，导致优化失败。必须确保指向的入口文件及其依赖树中，非必要的副作用已被剥离或明确标记。
