Webpack 5 在打包流程中引入了一项容易被忽视却十分关键的变化：对代码中法律注释的处理。过去，开发者使用压缩工具或开启生产模式时，第三方库头部常见的版权声明、许可证文本等注释很容易被当作无用内容直接剥离，这会给开源项目使用者带来潜在的法律风险。Webpack 5 通过 output.legalComments 配置项，将这些与法律相关的注释从业务代码中分离出来，形成统一的管理方式，这就是所谓的 Legal Impact 特性。
一、Legal Impact 特性的背景与默认行为
了解这个特性之前，需要先回顾一下旧版本 Webpack 的做法。在 Webpack 4 以及更早的版本中，如果开启了压缩插件（如 TerserWebpackPlugin），默认情况下所有注释都会被移除，除非手动配置 extractComments 或 comments 选项。很多团队并不清楚这一点，导致构建产物中丢失了第三方库的版权声明。例如，你使用了某个 MIT 协议的开源组件，但打包后其许可证文本不见了，这实际上已经违反了该许可证的再分发条件。
Webpack 5 对这个问题给出了系统性的解决方案。它新增了 output.legalComments 配置项，默认值为 eot。所谓 eot，是 end of text 的缩写，表示将代码中识别为法律注释的内容提取到每个 bundle 文件的末尾。这样一来，压缩阶段不会删除这些注释，它们仍然存在于产物中，只是被集中到了文件尾部，不再影响代码的可读性和执行效率。
这种默认行为意味着开发者无需额外配置，也能保留大部分许可证声明。不过，由于注释被集中到 bundle 尾部，如果一些工具或流程只读取文件开头，可能会错过这些信息。因此，在实际项目中，根据许可证的严格程度，你可能需要将配置调整为 linked 或 inline，以更稳妥地满足合规要求。
二、核心配置项 output.legalComments 的取值与法律含义
output.legalComments 支持四种主要取值：none、inline、eot 和 linked。none 表示完全不保留任何法律注释，这通常是最危险的选择，因为它会直接违反多数开源许可证的版权声明要求。inline 表示保持注释在源代码中的原始位置，适合那些希望产物体积变化最小、且不介意注释混在代码里的场景。eot 是默认值，已经在上一节介绍过，注释被收集到文件末尾。
linked 则是更推荐的方式，它会把所有法律注释提取到一个独立的 .LICENSE.txt 文件中，并在最终的 bundle 里留下一个指向该文件的引用。这样做的好处是业务代码完全干净，注释集中管理，法律审查时一目了然。下面是一段典型的 webpack.config.js 配置示例：
const path = require('path');
module.exports = {
mode: 'production',
entry: './src/index.js',
output: {
path: path.resolve(__dirname, 'dist'),
filename: 'bundle.js',
legalComments: 'linked',
},
optimization: {
minimize: true,
},
};
从法律角度看，不同许可证对版权声明的要求略有差异。MIT 许可证要求保留版权声明和许可声明，Apache-2.0 还要求保留 NOTICE 文件中的内容。GPL 系列许可证更为严格，除了保留声明外，还要求衍生作品同样以 GPL 协议发布。Webpack 5 的 legalComments 特性虽然不能自动识别所有类型的法律文本，但它至少提供了一种统一保留注释的机制，降低了人为遗漏的概率。
需要注意的是，legalComments 的识别基于注释中的特定关键词，例如 @license、@preserve、Copyright、License 等。如果你的依赖库使用了自定义的注释格式，可能不会被自动提取，这时就需要通过正则表达式进行补充匹配。配置对象形式可以更精细地控制提取规则，例如只提取包含特定前缀的注释。
三、实践中如何验证产物中的法律注释并避免风险
配置好 legalComments 之后，你应该在构建完成后检查输出目录。如果使用 linked 模式，dist 文件夹下会出现类似 bundle.js.LICENSE.txt 的文件，打开后可以看到各个第三方库的版权信息。此外，bundle.js 的顶部或尾部可能会有一行注释，指向这个 LICENSE 文件。建议将这一检查步骤纳入 CI 流程，确保每次构建都能自动验证法律注释是否被正确提取。
除了 Webpack 自身的提取机制，还可以借助 npm 生态中的 license-checker 等工具扫描项目的依赖树，生成所有包及其许可证的清单。将这份清单与构建产物中的 .LICENSE.txt 内容做交叉比对，可以发现哪些依赖的声明未被正确保留。这种双重验证方式对于大型项目尤其重要，因为依赖数量多，手动检查几乎不可能完成。
最后，需要注意 legalComments 特性并不等同于法律服务。它只是一个工程层面的辅助工具，不能替代对开源许可证条款的专业解读。如果你所在的公司有法务团队，建议将构建产物中的许可证声明文件定期交给法务审核。同时，当项目引入新的第三方库时，应养成查看其许可证类型的习惯，判断是否需要调整 legalComments 的值或手动补充声明。
总体而言，Webpack 5 的 Legal Impact 特性让构建工具承担起了许可证注释管理的一部分责任。通过合理地选择 output.legalComments 的配置值，并配合产物检查与依赖扫描，开发者可以在不牺牲构建效率的前提下，显著降低因注释丢失而引发的法律合规风险。
Webpack 5Legal Comments开源许可证修改时间：2026-10-02 01:01:46