HTMLHint检查失败却不阻断构建，根本原因是|| echo "检查完成"掩盖了退出码；正确做法是删除||、启用set -e严格模式、确保配置文件名和路径正确、使用兼容glob语法，并验证htmlhint版本≥0.16.0。
CI/CD 流程中 HTMLHint 检查失败却不阻断构建？
默认情况下，npx htmlhint 退出码为 1 时会中断后续步骤，但很多 GitHub Actions 配置里写了 || echo "检查完成"，这直接吞掉了错误信号，导致检查形同虚设。
真正起效的写法必须让失败传播出去：
- 删掉所有
||或|| true类掩盖退出码的操作 - 用
set -e开启 shell 严格模式（在run:步骤开头加sh -c 'set -e; npx htmlhint "**/*.html"'） - 确认
htmlhint版本 ≥ 0.16.0 —— 旧版本对某些规则（如attr-no-duplication）不报错，只警告
HTMLHint 规则在云构建环境里“不生效”？检查这三处
本地能报错、CI 里静默通过，大概率是规则未加载或路径不匹配。
-
.htmlhintrc必须放在项目根目录，且文件名不能是.htmlhint.json或htmlhint.config.js—— 云构建容器默认只认.htmlhintrc -
npx htmlhint "**/*.html"中的 glob 表达式在不同 shell 下行为不同：GitHub Actions 默认用bash，但某些镜像用sh，不支持**；改用find . -name "*.html" -exec npx htmlhint {} \; - 检查是否误启用了
--config参数指向了空配置或错误路径，优先用默认加载逻辑
为什么 HTMLProofer 比 HTMLHint 更适合部署前拦截？
HTMLHint 查语法和规范，HTMLProofer 查真实资源可用性——后者在部署前卡住更关键。
立即学习“前端免费学习笔记（深入）”；
-
HTMLProofer能发现404图片链接、失效跳转、缺失href的<a>标签，这些在静态检查阶段完全无法识别 - 它依赖 Ruby 环境，CI 中需显式安装：
run: sudo apt-get update && sudo apt-get install -y ruby-full，再gem install html-proofer - 务必加
--url-ignore "/^mailto:/, /^tel:/"这类忽略项，否则邮箱、电话链接会误报 - 对生成的静态站点目录（如
_site/或dist/）运行，不是源码目录 —— 源码里的占位符路径在构建后才变成真实路径
云构建里 HTML 质量检查的性能瓶颈在哪？
不是规则多，而是 I/O 和解析开销。100 个 HTML 文件在 CI 上跑 htmlhint 可能超时（尤其 Windows runner），根源在 Node.js 的 fs 模块逐个读取效率低。
- 用
--format=checkstyle输出并配合缓存（actions/cache@v4缓存node_modules）能省 3–5 秒 - 避免
"**/*.html"扫描整个 repo —— 提交前用git diff --name-only HEAD~1 | grep '\.html$'获取变更文件列表，只检查改动项 - 如果项目含大量模板（如
.ejs、.njk），htmlhint默认不处理，需额外配htmlhint --rulesdir ./rules加载自定义解析器
真正卡点往往不在规则本身，而在构建镜像里没装对依赖、glob 不展开、或把检查塞在了打包之后却忘了清理 dist 目录里的临时文件 —— 那些文件可能带未闭合标签，触发误报。
