从 ESM 静态分析讲起,说明 sideEffects 配置与常见失效场景。
Tree Shaking 依赖 ESM 的静态结构(import/export 在编译期确定),打包器从入口做模块级+声明级的可达性分析,删掉未被引用的 export。CommonJS 因 require 动态执行无法可靠分析,基本摇不掉。
生效条件:① 使用 ESM 语法(import/export);② package.json 声明 "sideEffects": false(或列出有副作用的文件),否则 bundler 不敢删「看似未用」的模块(如 import './polyfill');③ production 模式(TerserPlugin 负责最终删除 + usedExports 标记);④ Babel 配置 modules: false,防止转译成 CJS。
常见失效:① 引入了 UMD/CJS 版本的包;② import * as 全量引入;③ 类的方法(可能被反射调用,Terser 默认不删);④ 无 sideEffects 声明的第三方库。可用 webpack-bundle-analyzer 验证。
题目与答案就在本页;收藏、批注和错题重练在应用内