要强制裁剪无副作用的硬绑定片段,核心是启用Tree Shaking并满足ESM规范、生产模式、sideEffects配置正确、Babel不转译模块语法、避免动态导入和副作用代码,最后通过可视化工具验证裁剪结果。

要强制裁剪掉项目中“无任何副作用”的硬绑定片段(即未被引用、也未产生运行时影响的代码),核心是启用并正确配置 Tree Shaking,同时确保代码和构建工具满足其前提条件。
确认模块系统与导出方式符合 ES 模块规范
Tree Shaking 仅对 ESM(import/export) 生效,CommonJS(require/module.exports)会被视为有副作用而保留。
- 确保源码使用
export const func = () => {}而非module.exports = { func } - 避免在 ESM 文件中混用
require或修改全局对象(如window.xxx = ...),这类操作会被 Webpack/Rollup 判定为有副作用 - 第三方库若使用 CommonJS,需通过
package.json中的"sideEffects": false显式声明无副作用;若部分文件有副作用(如 CSS 导入、polyfill),应列出白名单,例如:"sideEffects": ["*.css", "*.scss"]
启用生产模式并关闭副作用干扰项
Webpack 默认在 mode: 'production' 下开启 Tree Shaking,但以下配置必须到位:
- 禁止使用
eval类 devtool(如eval-source-map),它会阻止代码标记为“可摇除” - 确保
optimization.concatenateModules保持启用(默认开启),它合并模块以提升静态分析准确性 - 避免在
module.rules中对 JS 使用带副作用的 loader(如某些老版本babel-loader插入的 polyfill 注入),建议用@babel/preset-env的modules: false配置保留学号
识别并剔除隐式副作用代码
所谓“硬绑定片段”,常指看似孤立但被间接依赖的代码,例如:
- 单独定义但从未
import的工具函数文件(utils/xxx.js)——只要没被任何入口或依赖链触达,就会被自动裁剪 - 仅用于类型提示的 TypeScript 接口或类型别名(.d.ts)——本身不参与打包,无需处理
- 写在
if (false)或死代码块中的逻辑——现代打包器(如 Webpack 5+、Rollup)能识别并移除,但需确保未启用optimization.minimize: false
验证裁剪结果是否生效
光靠配置不够,需主动检查:
- 用
webpack-bundle-analyzer查看产物模块构成,确认疑似冗余文件未出现在最终 chunk 中 - 在源码中添加一个只定义、未使用的函数,构建后搜索产物 bundle,确认其未出现(注意:若该函数被 Babel 转译出
typeof检查等残留,可能需调整 preset 配置) - 对 Rollup,可在配置中加
treeshake: { moduleSideEffects: false }进一步收紧判定(慎用,可能误删)

















