html-webpack-plugin 的 minify 配置需显式传对象（如 {}）才生效，minify: true 无效；collapseWhitespace 和 removeComments 是压缩体积的关键开关，缺一不可。
html-webpack-plugin 的 minify 配置必须显式传对象
默认不压缩，哪怕你开了 mode: 'production'。v5+ 版本中 minify: true 会被忽略，必须传一个对象（哪怕空对象 {}）才会触发压缩逻辑。
常见错误现象：index.html 在 dist 目录里仍保留换行、注释、多余空格，体积毫无变化。
-
minify: true→ 无效，插件直接跳过压缩 -
minify: false→ 明确禁用 -
minify: 'auto'→ 仅在生产环境启用，但依赖 Webpack 模式判断，CI 环境若未设NODE_ENV=production就会失效 -
minify: {}→ 最小有效配置，启用默认压缩行为（如移除注释、折叠空白）
collapseWhitespace 和 removeComments 是压缩生效的底线开关
这两个参数控制着 80% 以上的体积缩减效果。不开启它们，其他高级选项（如 minifyCSS）几乎无感。
使用场景：适用于所有现代浏览器支持的 HTML5 项目；若需兼容 IE8–9，慎用 removeScriptTypeAttributes 或 removeStyleLinkTypeAttributes，否则可能触发解析异常。
立即学习“前端免费学习笔记（深入）”；
-
collapseWhitespace: true→ 合并标签间多个空格/换行为单个空格，对<p> hello world </p><div class="aritcle_card flexRow"> <div class="artcardd flexRow"> <a class="aritcle_card_img" href="/xiazai/skill5806" title="html-deploy"><img src="https://img.php.cn/upload/skill/000/000/081/179066538882434.jpg" alt="html-deploy" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a href="/xiazai/skill5806" title="html-deploy">html-deploy</a> <p>使用 htmlcode.fun 将 HTML 内容或文件部署到网页，适用于用户要求“部署到网页”“托管此 HTML”“生成此前端...的实时链接”等场景。</p> </div> <a href="/xiazai/skill5806" title="html-deploy" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div>变成<p> hello world </p>；注意：它不会删掉文本节点内的首尾空格，避免影响 CSSwhite-space行为 -
removeComments: true→ 删除<!-- ... -->，但保留<!--[if IE]>...<![endif]-->条件注释（若需保留） -
removeRedundantAttributes: true→ 删掉type="text"、value=""（空值）等冗余属性，安全且推荐 -
minifyJS: true→ 风险项：会尝试压缩内联<script>，若含模板字符串或可选链（a?.b），可能被 terser 报错；建议改为minifyJS: { compress: false }或干脆关掉
缓存失效常因模板文件外的变量注入导致
html-webpack-plugin 的缓存基于模板文件内容快照，但如果你在 templateParameters 或 htmlWebpackPlugin.options 中动态注入了时间戳、构建哈希、环境变量等，每次构建都会让缓存失效。
性能影响：缓存失效意味着每次都要重新执行模板编译（包括 lodash.template 解析 + HTML 渲染），在大型多页应用中可能增加 200–500ms 构建耗时。
- 避免在模板中写
<!-- build: 类动态值 - 改用 Webpack 的
DefinePlugin注入常量，或把动态内容挪到 JS 中通过 DOM 操作插入 - 检查是否启用了
favicon或meta配置中的动态路径（如public/favicon-${hash}.ico），这类路径变更也会触发缓存重建 -
cache: false不解决根本问题，只是掩盖——应定位并收敛动态变量来源
服务端 Gzip 比 HTML 文件级压缩更值得优先投入
文件级压缩（如 html-webpack-plugin 压缩）通常只带来 10–25% 体积下降；而开启 Nginx 的 gzip on 或 Cloudflare 的 Brotli，对同一 HTML 文件可再压掉 60–80%，且零配置成本、全资源通用。
容易被忽略的地方：Webpack 构建时的 HTML 压缩和服务器传输压缩不是互斥关系，而是叠加生效。但若你在构建时过度激进（比如开 removeOptionalTags 导致某些旧版 Safari 解析失败），反而会让 Gzip 失去作用基础——因为损坏的 HTML 无法被浏览器正确加载，Gzip 再高效也无意义。
- 先确保 HTML 语法合法、渲染正常，再开压缩
- 用
curl -H "Accept-Encoding: gzip" -I http://yoursite.com/index.html验证响应头含Content-Encoding: gzip - 本地开发不用配 Gzip，但 CI/CD 流水线中要验证生成的 HTML 能被主流服务器正确识别为 text/html 并启用压缩
