HTMLHint的fix命令不能修复alt-require等语义类规则，因需人工判断装饰性图片应填alt=""、空字符串或删除标签；而tag-pair误报自闭合标签问题可通过配置"selfClosing": true解决。
HTML代码里的坏味道不会报错，但会让团队协作变慢、SEO掉坑、无障碍访问失效，甚至埋下渲染兼容性雷。靠人眼 review 效率低还容易漏，必须用工具链自动识别 + 可控修复。
为什么 HTMLHint 的 fix 命令不能直接修 alt-require 这类规则
HTMLHint 默认只对格式类规则（如 attr-value-double-quotes、indent）提供自动修复能力；而语义/可访问性类规则（如 alt-require、img-req-alt、head-title-require）需要人工判断上下文——比如一张装饰性图片该填空字符串还是 alt=""，还是该删掉 img 改用 CSS 背景。工具无法安全推断意图，所以不启用 --fix 时这些规则只警告，启用后也跳过。
- 检查是否支持修复：运行
htmlhint --rulesdir ./rules/ --rule 'attr-value-double-quotes: true' index.html --fix看能否生效；再试alt-require: true，会发现无变化 - 想强制补
alt？得自己写插件或用posthtml+ 自定义 transform，例如匹配<img src="..."/>后插入alt=""，但要加白名单过滤 SVG、图标字体等场景 - 团队落地建议：把
alt-require设为 error 级别，CI 流程中卡住构建，倒逼开发者补全，比“自动填空”更可靠
tag-pair 规则误报 <img> 或 <input> 未闭合怎么办
这是典型规则配置与 HTML5 标准脱节问题。tag-pair 默认按 XHTML 严格模式校验，把所有标签都当必须闭合处理，但 <img>、<input>、<br> 在 HTML5 中本就是自闭合标签，写成 <img src="x"> 完全合法。
- 正确做法：在
.htmlhintrc中关闭该规则的严格模式："tag-pair": ["error", { "selfClosing": true }] - 若仍报错，检查是否混用了 XHTML 风格写法，比如写了
<img src="x" />却没加空格（<img src="x"/>是非法的），浏览器能容错，但 HTMLHint 会捕获 - 注意：
<script>和<style>永远不是自闭合标签，漏写</script>会导致后续 JS 不执行，tag-pair报这个必须处理
如何让 doctype-first 规则兼容模板引擎生成的 HTML 片段
前端工程里常见 .html 是模板（如 EJS、Nunjucks），实际输出是拼接后的完整页面。这时单个片段文件开头没有 <!DOCTYPE html> 是合理的，但 HTMLHint 扫描单文件会报错。
立即学习“前端免费学习笔记（深入）”；
- 方案一：用
ignore字段排除模板目录，例如"ignore": ["src/templates/**/*"] - 方案二：改用
htmlhint --config .htmlhintrc src/**/*.html --file-ext .html，配合构建脚本只校验最终产出的dist/*.html - 方案三：在模板顶部加注释
<!-- htmlhint doctype-first: false -->，临时禁用该规则（适合老项目渐进改造）
真正难的不是加规则，而是让规则和工程流程咬合：CI 里卡哪条、本地 pre-commit 修哪些、谁来维护自定义规则集。一个没配好 selfClosing 的 tag-pair，可能让整个团队每天手动删几百个 /> ——这种细节，恰恰最消耗开发心力。
