html验证失败但流水线未中断，因ci中误用|| true吞掉htmlhint非零退出码；应删除该操作并配置failonerror:true，按需调整规则、校验资源路径、统一版本化.htmlhintrc。
HTML验证失败但流水线没中断？检查htmlhint退出码是否被忽略
默认情况下htmlhint发现错误会返回非零退出码，但有些CI配置里用|| true或set +e强行吞掉错误，导致“报错却继续执行”。GitLab CI中常见写法：script: - npx htmlhint **/*.html || true——这会让所有问题静默通过。
正确做法是让错误真实传递：
- 删掉
|| true，确保命令失败时整个job退出 - 若需兼容部分旧HTML（如第三方嵌入代码），改用
--quiet配合--max-warnings 0，把警告当错误处理 - 在
.htmlhintrc里明确设置"failOnError": true（部分版本默认为false）
htmlhint规则与团队实际需求不匹配？别硬套默认配置
开箱即用的htmlhint规则集（如htmlhint:recommended）偏保守：强制alt属性、禁止内联样式、要求lang属性。但现实中，你可能：
- 允许部分组件使用
style属性（如邮件模板中为兼容性保留） - 暂时容忍缺失
alt（因CMS生成图片未提供描述，需后端补） - 对
iframe来源不做sandbox限制（内部管理后台场景）
解决方案：在.htmlhintrc中针对性关闭规则，而不是全量禁用：
{
"rules": {
"attr-no-unsafe-char": true,
"attr-lowercase": true,
"attr-no-duplication": true,
"tag-pair": true,
"id-unique": true,
"img-alt-req": false,
"inline-style-disabled": false
}
}
静态资源路径在CI中失效？htmlhint不解析运行时路径
htmlhint只做语法和结构校验，不加载外部资源，因此它无法判断<link href="/static/css/app.css">在部署后是否存在。这类问题常表现为本地能跑、CI里报404，但htmlhint完全不报错。
必须拆开处理：
- 路径合法性交给
html-validate（支持href/src存在性校验）或自定义脚本 - 在CI中加一步
curl -I探测关键静态资源HTTP状态码 - 若用Webpack/Vite构建，启用
html-webpack-plugin的minify.removeEmptyAttributes等选项，避免生成无效路径
多分支并行检测时规则不同步？.htmlhintrc必须纳入版本控制
有人把.htmlhintrc放在~/.htmlhintrc或CI runner全局目录下，导致dev分支用宽松规则、main分支用严格规则，合并后才发现main构建失败。
可靠做法只有这一种：
- 把
.htmlhintrc放在项目根目录，和代码一起提交 - CI脚本中显式指定配置路径：
npx htmlhint --config .htmlhintrc src/**/*.html - 禁止在CI中使用
--global或HTMLHINT_CONFIG环境变量覆盖本地配置
真正卡住上线的不是某条HTML语法错误，而是规则配置没随代码流动——它让“合规”变成不可复现的偶然结果。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
