在 rollup 中实现 tree shaking 的核心是确保代码符合 es module (esm) 规范,并正确配置构建工具。rollup 默认会对 esm 进行静态分析以移除未使用的导出,因此只需将入口文件设为 `.mjs` 或配置 `type: 'module'`,并在 `rollup.config.js` 中通过 `input` 指定入口即可生效。如果项目中混用了 commonjs (cjs),则需要使用 `@rollup/plugin-commonjs` 插件将其转换为 esm,否则 rollup 无法安全地执行摇树优化。

如何配置 Rollup 以启用 Tree Shaking
要启用 Tree Shaking,必须在配置文件中使用 `rollup()` 函数并传入包含 `input` 和 `plugins` 的配置对象。关键在于使用 `@rollup/plugin-node-resolve` 来解析 `node_modules` 中的依赖,以及使用 `@rollup/plugin-commonjs` 来处理非 ESM 模块。配置完成后,运行 `rollup -c` 命令即可生成经过优化的包。

// rollup.config.js
import resolve from '@rollup/plugin-node-resolve';
import commonjs from '@rollup/plugin-commonjs';
export default {
input: 'src/index.mjs',
output: {
file: 'dist/bundle.js',
format: 'esm'
},
plugins: [
resolve(),
commonjs()
]
};上述配置中,`input` 指向项目的入口文件,`output.format` 设置为 `esm` 以保留模块结构供后续处理。`resolve` 插件帮助找到第三方库,`commonjs` 插件则负责转换 CJS 代码。当运行此配置时,Rollup 会分析 `src/index.mjs` 及其依赖树,剔除未引用的代码。
立即学习“Java免费学习笔记(深入)”;
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
为什么 CommonJS 模块会导致 Tree Shaking 失效
CommonJS (CJS) 模块使用 `require` 和 `module.exports`,其加载机制是动态的,允许在运行时修改导出对象。这种动态特性使得静态分析工具难以确定哪些导出真正被使用,因此 Rollup 默认不会对纯 CJS 模块进行 Tree Shaking。如果直接引入 CJS 库,整个库的代码都会被打包进最终产物中,导致体积膨胀。

// src/utils.cjs (CommonJS)
module.exports = {
add: (a, b) => a + b,
subtract: (a, b) => a - b
};
// src/index.mjs (ESM)
import { add } from './utils.cjs'; // 注意:这里需要插件支持
console.log(add(1, 2));在上述示例中,如果 `utils.cjs` 没有被 `@rollup/plugin-commonjs` 转换,Rollup 可能会将整个 `utils.cjs` 的内容打包,即使只使用了 `add` 函数。这是因为 CJS 的 `module.exports` 是一个对象,Rollup 无法静态判断是否只访问了其中的某个属性。通过 `commonjs` 插件,该文件会被转换为 ESM 格式,从而允许 Rollup 进行精确的摇树优化。
如何处理第三方库中的未使用代码
对于第三方库,Tree Shaking 的效果取决于库本身的发布格式。如果库以 ESM 格式发布(通常通过 `package.json` 中的 `exports` 或 `module` 字段标识),Rollup 可以自动剔除未使用的部分。但如果库仅发布 CJS 格式,或者其内部逻辑存在副作用,可能需要额外配置。例如,某些库可能在顶层执行了副作用代码,这些代码不会被剔除,但未被调用的函数可以被移除。
// package.json 中的 ESM 标识
{
"name": "my-lib",
"main": "index.cjs",
"module": "index.mjs",
"exports": {
".": {
"import": "./index.mjs",
"require": "./index.cjs"
}
}
}当 Rollup 解析 `my-lib` 时,它会优先选择 `index.mjs`(如果 `format` 为 `esm`)。此时,如果用户只导入了 `my-lib` 中的一个函数,Rollup 会分析 `index.mjs` 的依赖图,并剔除其他未使用的导出。然而,如果 `index.mjs` 在顶层有副作用(如注册全局变量),这些副作用代码会被保留,以确保程序行为正确。开发者应确保第三方库尽可能提供 ESM 版本,以获得最佳的 Tree Shaking 效果。

















