应返回新数组而非原地修改标签，结合 chunk 信息判断 JS 资源，避免覆盖已有 attributes；beforeEmit 仅适用于无损变更，禁用正则替换 HTML。
如何在 alterAssetTags 钩子里安全修改 script 标签
这个钩子是拦截资源注入最常用的入口，但直接 mutate data.headTags 或 data.bodyTags 数组容易引发副作用——比如重复添加标签、破坏原有顺序、或被后续插件覆盖。
正确做法是返回一个全新数组，并确保每个标签对象符合 html-webpack-plugin 的内部结构要求（必须含 tagName、attributes、innerHTML 等字段）。
- 不要用
push()或splice()原地修改data.bodyTags，应构造新数组：[...data.bodyTags, createHtmlTagObject(...)] - 判断是否为 JS 资源时，别只靠文件后缀，要结合
compilation.assets中的 chunk 信息，否则可能误判 source map 或内联 chunk - 如果需加
nonce或crossorigin，务必检查原attributes是否已存在同名键，避免覆盖用户手动配置
为什么 beforeEmit 钩子不适合做 HTML 内容重写
很多开发者想在这里读取生成的 HTML 字符串再正则替换，这是高风险操作：此时 HTML 已完成模板渲染和资源注入，但尚未经过 minify 处理；若你手动压缩或删空格，会和插件内置的 minify 逻辑冲突，导致格式错乱甚至 JS 执行失败。
真正该用 beforeEmit 的场景，仅限于对最终 HTML 字符串做无损变更，比如注入 runtime 环境变量、追加不可见注释、或打点埋点脚本。
立即学习“前端免费学习笔记（深入）”；
- 绝对不要在
beforeEmit中执行html.replace(/<script async> 这类粗暴替换</script> - 若必须改内容，优先走
afterTemplateExecution—— 此时拿到的是未注入资源的原始模板字符串，改动更可控 -
beforeEmit的compilation.assets[filename]是source对象，调用.source()才能拿到字符串，别直接 toString()
多实例插件下如何避免 hooks 注册冲突
当你同时使用多个自定义插件（比如一个加 CSP nonce，另一个加性能监控 script），它们都通过 HtmlWebpackPlugin.getCompilationHooks(compilation) 获取钩子，但若都用相同 tap 名称，Webpack 会按注册顺序依次执行，无法控制先后——这会导致 nonce 被后注册的插件覆盖，或监控脚本插入位置错误。
解决方式不是靠“谁先注册谁优先”，而是用唯一标识 + 条件过滤：
- 每个插件的
tap名称必须带项目前缀，如'MyCspPlugin-alterAssetTags'，而非泛泛的'alterAssetTags' - 在钩子回调里主动检查当前 HTML 实例的配置，例如
if (htmlPluginOptions.filename !== 'admin.html') return callback(null, data) - 避免在
compilation级别共享状态（如全局 Map），不同 HTML 实例的compilation是隔离的，但compiler是全局的
inject: false 时，如何手动注入特定 chunk
设为 inject: false 后，插件完全不处理资源标签，但你仍可能需要把某个 vendor chunk 插入到 head，或把 polyfill 放在 body 开头。这时不能依赖 alterAssetTags，因为 data 里根本没标签数据。
可行路径只有两条：一是改模板（用 EJS/Handlebars 在 template 文件里手动写 <script src=""></script>），二是用 afterTemplateExecution 钩子解析 HTML 字符串并 DOM 操作。
- DOM 操作推荐用
jsdom，但注意它会引入额外依赖和启动开销；生产环境慎用 - 若只注入静态已知 chunk，优先走模板方案——更轻量、可调试、不破坏构建流水线
-
compilation.assets中的 key 是输出文件名（如'vendor.js'），但 publicPath 可能被output.publicPath修改，别硬编码路径
data 的竞态修改——尤其当团队里有人写了“偷偷 patch 标签”的插件，又没文档说明，后期排查成本极高。 
