HTMLHint在CI中常因未设--fail-on-warn/--fail-on-error而静默退出（返回码0），导致扫描失效；须显式指定--config .htmlhintrc、限定扫描dist/index.html等入口文件，并按框架兼容性调整规则，如禁用attr-lowercase、启用doctype-first和img-alt-require。
HTML 代码质量在前端流水线中常被忽略，但实际它直接影响可访问性、SEO 和跨浏览器兼容性。静默扫描不是加个工具就完事——必须让 HTMLHint 或类似工具不打断开发节奏，又能真实拦截问题。
HTMLHint 在 CI 流水线里为什么总报错却不阻断？
常见现象是 htmlhint 在本地跑通，CI 中却因路径、编码或配置加载失败而静默退出（返回码 0），导致“看似扫描了，实则没生效”。根本原因是默认不启用 --fail-on-warn，且未校验退出码。
- 必须显式添加
--fail-on-warn或--fail-on-error，否则警告（warning）不会触发构建失败 - 检查 CI 中执行路径是否包含
.htmlhintrc：Vite/Webpack 构建产物目录下通常没有该文件，应统一放在项目根目录并用--config .htmlhintrc显式指定 - Node.js 版本差异可能导致插件解析失败，建议在 CI 中固定使用
node:18或node:20镜像
如何让 HTML 扫描不拖慢构建速度？
全量扫描 dist/ 下所有 HTML 文件（尤其含大量模板片段时）会显著延长 CI 时间。关键不是跳过扫描，而是精准限定范围。
Article To Html
下载
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- 只扫描最终输出的入口 HTML（如
dist/index.html），用htmlhint dist/index.html替代htmlhint dist/**/*.html - 若项目含多个入口（如多页应用），用 shell 脚本生成明确列表：
find dist -name "index.html" -o -name "404.html" | xargs htmlhint --config .htmlhintrc - 避免在
prebuild阶段扫描源码 HTML（如src/*.html），因为此时语义结构未定型，误报率高；应等构建完成后再扫产物
HTMLHint 规则怎么选才不误伤业务？
开箱即用的 htmlhint 规则集（如 htmlhint:recommended）对现代框架项目过于激进——比如强制 attr-lowercase 会和 Vue 的 v-if、React 的 data-* 属性冲突。
立即学习“前端免费学习笔记（深入）”；
- 禁用与框架不兼容的规则：
"attr-lowercase": false、"attr-no-duplication": false（JSX/模板中动态属性可能重复） - 必启核心规则：
"doctype-first": true、"head-script-disabled": true、"img-alt-require": true（直接影响可访问性和 SEO） - 对自定义元素（如
<my-button>）需关闭"tag-name-lowercase"，否则会把合法的 Web Component 当错误
静默扫描真正的难点不在工具接入，而在规则与业务边界的对齐——同一份 .htmlhintrc 在 SSR 项目和纯静态站点中含义完全不同。每次升级框架或引入新构建插件，都得重新验证 HTML 输出结构是否仍符合扫描预期。
