tree shaking 模块合并通过静态分析 es module 的导入导出关系,剔除未使用的代码并优化打包结构。核心做法是确保使用 es module 语法(import/export),并在构建工具(如 webpack、vite)中开启生产模式或明确配置 sideeffects:false,这样工具就能安全地移除死代码。

如何配置以启用 Tree Shaking
要启用 Tree Shaking,必须使用 ES Module 格式的代码,并在构建配置中标记无副作用的文件。在 Webpack 中,这通常意味着设置 mode: 'production' 或在 optimization.usedExports 和 optimization.minimize 中显式开启。对于 Vite,由于基于 Rollup,默认在生产构建时就会执行此操作,但需要正确配置 package.json 中的 sideEffects 字段来加速处理。

{
"name": "my-app",
"sideEffects": false
}
上述配置告诉打包器,当前项目中的所有文件都没有副作用(如全局变量污染或样式注入),因此可以安全地丢弃任何未被直接引用的模块。如果项目中包含 CSS 文件或某些特定的脚本文件,需要在数组中列出它们,例如 ["*.css", "src/polyfill.js"],以防止这些必要文件被误删。
为什么 CommonJS 无法被 Tree Shaking
CommonJS (CJS) 模块采用动态加载机制,其导出对象是在运行时确定的,而 Tree Shaking 依赖的是编译时的静态分析。因为 CJS 的 module.exports 是一个可变的对象引用,打包器无法在构建阶段确切知道哪些属性会被最终使用,所以默认情况下会保留整个模块,导致无法进行有效的摇树优化。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

// utils.js (CommonJS)
const add = (a, b) => a + b;
const subtract = (a, b) => a - b;
module.exports = { add, subtract };
// main.js
const { add } = require('./utils');
console.log(add(1, 2));
在上述 CJS 示例中,即使只使用了 add,打包器也无法确定 subtract 是否会在运行时通过某种动态方式被访问,因此会将整个 utils.js 模块打包进最终产物中。相比之下,如果使用 ES Module 语法 export const add...,打包器可以精确追踪到只有 add 被引用,从而将 subtract 从输出中移除。
sideEffects 设置为 true 时的具体影响
当 sideEffects 设置为 true 或未定义时,打包器会保守地保留所有模块,即使它们看起来没有被直接使用。这是因为存在副作用的代码(如修改全局状态、注册事件监听器)可能在模块加载时产生重要影响,忽略它们可能导致应用行为异常。此时,Tree Shaking 仅能移除那些完全未被引用的“死”模块,而无法对模块内部未使用的导出进行裁剪。
{
"name": "my-app",
"sideEffects": true
}
在这种配置下,即便 main.js 只导入了 add 函数,utils.js 中的 subtract 函数依然会被包含在最终的 bundle 中。这是因为打包器假设 utils.js 的任何部分都可能产生副作用,或者该模块本身可能被其他隐式依赖所触发。开发者若希望获得更小的包体积,必须仔细审查代码,确认哪些文件确实没有副作用,并将它们从 sideEffects 列表中移除,或者直接将值设为 false。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










