静态站点的 HTML 往往带着大量缩进、空行和模板注释——它们对浏览器毫无意义,却实打实占着传输体积。xfm-plugin-minify 是 xfmpress 官方的 HTML 压缩插件,在生产构建时把这些死重清掉,同时小心避开所有不该碰的内容。它和 SEO 插件 一样属于「装上就受益」的收尾型插件。
它解决什么
压缩器最大的风险是误伤:删错一个空格,行内元素的间距就没了;碰一下 <pre>,代码格式就乱了。本插件的做法是先把保护名单里的块整体摘出、压完再放回去,其余部分只删确定安全的空白。
安装与配置
npm i -D xfm-plugin-minify装完即生效,或在 配置文件 里显式声明:
// xfm.config.mjs
export default {
plugins: ['minify'],
minify: {
enabled: true, // 默认开启,写 false 可整体关闭
aggressive: false, // true 时额外折叠标签之间的换行
},
};产物与行为
默认模式做四件事:
- 删除 HTML 注释,但保留
<!--[if ...]>条件注释 - 删除行尾空白与只含空白的行
- 删除行首缩进(保留换行符,渲染结果不变)
- 合并连续空行
保护名单:<pre>、<code>、<textarea>、<script>、<style> 五类元素整体跳过,内容一字不动——代码缩进、脚本换行、CSS 格式都保持原样。
默认模式为什么保守:它只折叠「跨行」的空白,不碰同一行里的单个空格。<a>甲</a> <b>乙</b> 中间那个空格是行内元素之间的语义间距,删掉会让文字粘成一坨,所以默认模式绝不碰它。
dev 模式完全不压缩:xfm dev 下源码保持可读,热更新和调试时看生成的 HTML 更直观。压缩只发生在 xfm build。
注意事项
aggressive: true 会额外把标签之间的换行折叠掉(>\n< 变 ><),产物更小,但可能影响依赖标签间距的行内布局——如果你不确定主题是否依赖这些换行,先保持默认的 false,用浏览器开发者工具对比一下再决定。与其他插件的先后配合无需操心:压缩作用于最终 HTML,对 math 产出的 KaTeX 片段同样安全。插件生态总览见官方插件。
评论