tree shaking 是一种通过静态分析消除 javascript 代码中未引用(dead code)的优化技术,通常由打包工具如 webpack 或 rollup 在构建阶段执行。要启用此功能,必须确保源代码使用 es module (esm) 语法进行导入导出,并在打包配置中将环境模式设置为生产环境(production),这样打包器才能安全地移除那些被定义但从未被调用的函数、变量和模块。

为什么 CommonJS 无法被 Tree Shaking
CommonJS 模块系统采用动态加载机制,其 `require` 语句在运行时才会执行并返回一个对象,这意味着打包器在静态分析阶段无法确定该模块具体导出了哪些内容,因此无法安全地进行裁剪。相比之下,ES Modules 是静态的,编译器可以在不运行代码的情况下解析出所有的依赖关系和导出项,从而精准识别出未被使用的部分。

// utils.js (ESM - 可被摇树)
export const usedFunc = () => 'used';
export const unusedFunc = () => 'unused';
// main.js (ESM - 仅导入需要的)
import { usedFunc } from './utils.js';
console.log(usedFunc());
// build.js (模拟打包过程)
const fs = require('fs');
const code = fs.readFileSync('main.js', 'utf8');
console.log('Analyzing ESM dependencies...');
console.log('Result: unusedFunc is removed because it is not imported.');
如何配置 Webpack 以启用 Tree Shaking
在 Webpack 中启用 Tree Shaking 需要两个关键步骤:一是将打包模式设置为 production,二是确保代码符合纯函数和无副作用的要求。Webpack 默认在生产模式下会自动开启此功能,但如果开发环境中存在副作用(如修改全局变量),则需要手动配置 optimization 选项来强制剥离这些代码。

// webpack.config.js
module.exports = {
mode: 'production', // 关键:启用生产模式
optimization: {
usedExports: true, // 标记已使用的导出
sideEffects: true, // 启用副作用检测
},
entry: './src/index.js',
output: {
filename: 'bundle.js'
}
};
// package.json 中的 sideEffects 配置示例
// "sideEffects": false 表示所有文件都是纯函数,可安全摇树
// "sideEffects": ["./src/polyfill.js"] 指定特定文件有副作用,不被移除
副作用对 Tree Shaking 的影响
如果某个模块在执行时会改变全局状态或影响其他代码(例如 polyfills 或样式文件),Tree Shaking 可能会误删该模块,导致应用出错。为了解决这个问题,需要在 package.json 中明确声明哪些文件具有副作用,或者确保业务代码遵循纯函数原则,即不修改外部状态,这样打包器才能放心地移除未引用的模块。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











