Webpack如何开启TreeShaking删除无用代码

Webpack 的 Tree Shaking 是一种基于 ES6 静态模块语法的智能代码优化机制，能在构建时精准识别并剔除未被引用的导出（如未使用的函数或变量），显著减小打包体积；其核心依赖于 import/export 的静态可分析性，配合 AST 解析标记和 Terser 压缩阶段的实际删除，再辅以合理的 sideEffects 配置，即可安全高效地消除死代码——但需注意避开 CommonJS、动态导入和隐式副作用等常见“陷阱”，才能真正释放这一特性的全部威力。

Tree Shaking 是一种在构建过程中消除未使用代码（死代码）的机制，主要依赖于 ES6 模块系统的静态结构特性。Webpack 利用这一机制来实现更高效的打包结果。

基于 ES6 静态导入导出

Tree Shaking 能够工作的前提是使用 ES6 的 import 和 export 语法。这类模块引用是静态的，也就是说，在编译阶段就能明确知道哪些函数或变量被引入、哪些被导出。这使得打包工具可以在不运行代码的情况下分析模块间的依赖关系。

例如：

如果另一个文件只 import { usedFunc } from './utils';，那么 unusedFunc 就不会被打包进最终输出。

标记未引用的导出

Webpack 在打包时会分析每个模块的引用情况。它通过标记（marking）的方式识别出哪些导出没有被任何其他模块使用。这些未被引用的导出会在后续步骤中被标记为“可移除”。

这个过程发生在 AST（抽象语法树）解析阶段，Webpack 或其内部使用的工具（如 terser）能够判断某个函数、变量是否参与执行路径。

借助压缩工具真正删除代码

虽然 Webpack 可以标记未使用的代码，但真正将其从输出中移除的是压缩阶段，通常是通过 terser-webpack-plugin 实现的。

在生产模式下，Terser 会进行如下操作：

• 删除被标记为未使用的函数和变量声明
• 清除无副作用的表达式
• 进一步压缩代码体积

注意：只有当模块被认为是“无副作用”时，Tree Shaking 才能安全地移除代码。你可以在 package.json 中设置 "sideEffects": false 来告知 Webpack 整个项目没有副作用，或者列出有副作用的文件。

限制与注意事项

Tree Shaking 并非万能，以下情况会影响其效果：

• 使用 CommonJS 模块（require/module.exports）无法静态分析，因此不能被 shake 掉
• 动态导入（如 import() 表达式）中的模块不会参与 Tree Shaking
• 即使函数未被调用，若其父对象被引用，仍可能保留在打包结果中
• 带有副作用的代码（如立即执行函数、全局配置）需要特别标注，否则可能误删

基本上就这些。只要保持使用 ES6 模块语法、合理配置 sideEffects，并启用生产环境压缩，Webpack 就能有效通过 Tree Shaking 去除死代码。

本篇关于《Webpack如何开启TreeShaking删除无用代码》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！