Tree Shaking 是一种基于 ES6 模块静态分析的构建优化技术,通过标记并剔除未使用的代码来减小打包体积;它依赖于静态的 import/export 语法,不支持 CommonJS 动态模块,在生产模式下结合 Terser 等压缩工具生效,且需在 package.json 中配置 sideEffects 以帮助构建工具判断代码是否可安全删除。
Tree Shaking 并不是 JavaScript 本身的特性,而是一种在构建阶段通过静态分析消除未使用代码(dead code)的优化技术,常用于现代前端构建工具如 Webpack、Rollup 和 Vite 中。它的核心目标是减小打包体积,只将实际用到的代码包含进最终的输出文件中。
Tree Shaking 能够工作的前提是使用 ES6 模块(import/export),因为它们具有以下特点:
注意:CommonJS 模块(require/module.exports)是动态的,无法在编译时确定依赖关系,因此不支持 Tree Shaking。
构建流程通常分为两个阶段:
例如:
// math.js export const add = (a, b) => a + b; export const subtract = (a, b) => a - b;// main.js import { add } from './math.js'; console.log(add(2, 3));
在这个例子中,subtract 函数没有被引入,因此在启用 Tree Shaking 的情况下,它不会被打包进最终结果中。
即使使用了 ES6 模块,某些代码仍可能因为“副作用”而无法被安全删除。副作用指的是模块执行时除了导出值之外的操作,比如:
为了帮助构建工具判断是否可以安全删除模块,package.json 中可以设置:
"sideEffects": false
表示该项目所有文件都没有副作用,可放心进行 Tree Shaking。如果有特例,也可以写成数组形式:
"sideEffects": ["./src/polyfill.js"]
Tree Shaking 通常只在生产构建中生
效,原因如下:
基本上就这些。Tree Shaking 不复杂但容易忽略细节,关键是用对模块系统并正确配置副作用。