javascript tree shaking 首屏优化需要配合构建工具(如 webpack、vite)的 side effects 配置与代码的纯函数/模块设计,通过标记无副作用的文件并启用生产模式压缩,剔除未使用的导出代码。具体做法是在 package.json 中声明 sideeffects,确保构建工具能安全地移除死代码,同时保持入口文件精简,仅引入首屏必需的核心逻辑。

如何配置 sideEffects 以允许安全删除
在 package.json 中设置 sideEffects 字段是开启 Tree Shaking 的前提。如果该字段缺失或配置不当,构建工具会假设所有模块都有副作用(如修改全局变量),从而保留所有导入的代码,即使它们未被使用。正确的做法是列出包含副作用的文件(如 CSS 或 polyfills),或者将数组设为 false 表示所有文件都是纯模块。

{
"name": "my-app",
"version": "1.0.0",
"sideEffects": false
}
当 sideEffects 设为 false 时,Webpack 或 Vite 在生产构建中会扫描所有 ES Module 导入。如果某个导出的函数或变量在入口文件中没有被引用,它将被从最终的 bundle 中移除。这要求开发者严格遵守纯模块规范,避免在模块顶层执行不可逆的全局操作。
为什么必须使用 ES Modules (ESM) 语法
Tree Shaking 依赖于静态分析,而只有 ES Modules (import/export) 提供了明确的静态结构。CommonJS (require/module.exports) 是动态执行的,构建工具无法在编译时确定哪些依赖真正被使用,因此无法进行有效的摇树优化。必须将代码库迁移至 ESM 标准,才能利用现代打包工具的优化能力。

// utils/math.js
export const add = (a, b) => a + b;
export const multiply = (a, b) => a * b;
// app.js
import { add } from './utils/math'; // multiply 不会被打包
console.log(add(1, 2));
在上述示例中,app.js 只导入了 add 函数。由于使用了 export 和 import 语法,构建工具可以精确识别 multiply 未被使用,并在最终输出的 JavaScript 文件中将其剔除。如果使用 CommonJS,整个 math.js 文件都会被包含进来,无论是否使用了其中的所有函数。
如何处理带有副作用的第三方库
某些第三方库虽然提供了 ES Module 接口,但在导入时会执行全局样式注入或原型扩展等副作用。例如,导入一个 CSS 文件或 Polyfill 库。如果在 sideEffects 中未正确标记这些文件,构建工具可能会错误地删除它们,导致运行时错误。需要在 package.json 中明确指定这些文件的路径。
{
"sideEffects": [
"./src/styles.css",
"./src/polyfills.js"
]
}
通过这种方式,构建工具知道这些特定文件必须被保留,即使它们的导出未被直接引用。对于没有副作用的纯 JS 库,保持 sideEffects: false 即可最大化优化效果。这种精细控制确保了首屏加载的代码既最小化又功能完整。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











