htmlhint默认不启用核心规则，需手动配置.htmlhintrc启用tag-pair等规则才能检测标签未闭合等问题；路径、大小写敏感、vue兼容性及ci环境差异均可能导致检查失效。
HTMLHint 不是开箱即用的“一键检测”，必须显式启用关键规则、配好配置文件、处理路径和上下文兼容性，否则多数检查根本不会触发。
为什么 npx htmlhint index.html 没报错，但实际有标签没闭合？
默认规则集极简，tag-pair、attr-lowercase、id-unique 等核心规则全都不启用。它只检查极少数基础语法（如 malformed doctype），不是“默认全开”。
- 必须手动在
.htmlhintrc中设"tag-pair": true才能捕获<div><p>text</p><div class="aritcle_card flexRow artxards"> <div class="artcardd flexRow"> <a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill4293" title="Doc To HTML"><img src="https://img.php.cn/upload/skill/000/000/081/178998486916110.jpg" alt="Doc To HTML" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a rel="nofollow" href="/xiazai/skill4293" title="Doc To HTML" class="overflowclass">Doc To HTML</a> <p class="overflowclass">使用 MinerU 文档处理引擎将 Word 文档（.doc、.docx）转换为保留结构和格式的干净 HTML。</p> </div> <a rel="nofollow" href="/xiazai/skill4293" title="Doc To HTML" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div></div>这类嵌套错误 - 错误定位精准到行号列号，比如
index.html:12:5: Tag must be paired. - 自闭合标签（
<img>、<input>）不归tag-pair管——它只管“开多闭少”或“闭多开少”，不管 HTML5 是否允许省略斜杠 - 若项目含 Pug 或 JSX 片段，直接扫描会误报，此时应禁用该规则或限定扫描范围：
npx htmlhint "src/pages/**/*.html"
如何让 attr-value-double-quotes 不在 Vue 模板里炸锅？
这个规则对双引号嵌套极其敏感，而 Vue 的 v-bind 表达式天然混用单双引号，硬开等于自找麻烦。
- 推荐改用更灵活的
"attr-value-quote-style": "double"（仅 HTMLHint v1.0+ 支持），它允许属性值内含单引号，只要外层是双引号即可 - 若用旧版，只能设
"attr-value-double-quotes": false，再配合"attr-no-duplication": true防重复属性 - 内联 JSON 属性如
data-config='{"key":"val"}'也容易冲突，建议统一用单引号包裹整个值，并关掉该规则 - 临时绕过：命令行加
--rules attr-value-double-quotes:false
CI/CD 中 HTMLHint 报错但本地不报，常见原因有哪些？
根本矛盾在于环境路径、配置加载和 glob 展开行为不一致，不是工具本身问题。
-
.htmlhintrc必须放在项目根目录，HTMLHint 只向上查一级父目录，放错位置就等于没配 - GitHub Actions 中 shell 默认不支持
**深度展开，npx htmlhint src/**/*.html在某些 runner 上会失败，必须加双引号：npx htmlhint "src/**/*.html" - CI 环境 Node.js 版本可能偏低，HTMLHint v1.0+ 需 Node.js ≥14，检查
actions/setup-node@v4是否指定了足够新版本 - SARIF 输出需配合
github/codeql-action/upload-sarif@v3，且permissions必须包含security-events: write，否则上传静默失败
最易被忽略的点：规则名大小写敏感，"Tagname-Lowercase" 或 "tagname_lowercase" 都不会生效，必须严格按文档写成 "tagname-lowercase"；另外，VS Code 插件依赖工作区根目录存在 .htmlhintrc，打开子文件夹时若没继承配置，提示就消失。这些细节不验证，检查就形同虚设。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
