htmlhint接入ci需避免构建卡住：必须用--format=checkstyle或--format=unix，禁用可读格式；配合--rule "attr-lowercase: 0"临时关闭规则；指定--config路径防配置丢失；结合lint-staged仅检查暂存区文件。
HTMLHint 怎么接入 CI 流水线才不卡住构建
HTMLHint 本身不阻断构建，但默认配置下遇到警告就 exit 1，导致流水线失败——这不是 bug，是设计意图。关键在 reporter 和 --format 的组合用法。
- CI 中必须用
--format=checkstyle或--format=unix，避免 human-readable 格式干扰解析 - 加
--rule "attr-lowercase: 0"临时关闭某条规则（比如 legacy 项目里大量驼峰属性），比全局禁用更可控 - 别把
htmlhint放在pre-commit钩子里跑全量文件，应配合lint-staged只检查暂存区 HTML 文件，否则每次提交都扫整个src/目录，耗时飙升 - GitHub Actions 示例中常见错误：直接写
run: npx htmlhint ./src/**/*.html，没指定--config路径，导致本地能过、CI 报Cannot find config file
HTML ESLint 插件和原生 HTMLHint 冲突吗
不冲突，但混用会重复报错且规则覆盖难追踪。HTML ESLint 本质是把 HTML 解析逻辑塞进 ESLint 生态，依赖 eslint-plugin-html 或 @html-eslint/eslint-plugin，而 HTMLHint 是独立进程。
- 若项目已用 ESLint 管理 JS + Vue/Svelte 模板，优先选
@html-eslint/eslint-plugin，它支持.vue和.svelte中的 HTML 片段，HTMLHint 不行 - 纯静态站点（只有 .html 文件）用 HTMLHint 更轻量，启动快、规则更聚焦语义化和可访问性
- 两者都启用时，
alt-text-missing这类规则可能在两个工具里各报一次，CI 日志变冗长，建议统一入口 - 注意
eslint-plugin-html已废弃，新项目必须用@html-eslint/eslint-plugin，否则解析 JSX-style HTML 会崩
怎么让 HTML 静态扫描结果进 SonarQube
SonarQube 原生不认 HTMLHint 或 HTML ESLint 的输出格式，必须转成通用的 checkstyle 或 generic 格式才能导入。
- HTMLHint 输出
checkstyle格式后，用 SonarQube 的sonar.eslint.reportPaths配置项指向该文件（即使名字带 htmlhint，只要格式对就行） - HTML ESLint 必须配
eslint --format=checkstyle --output-file=eslint-report.xml，再通过sonar.eslint.reportPaths=eslint-report.xml注入 - 常见坑：
sonar.language=html不能省，否则 SonarQube 当作未知语言跳过分析；且sonar.sources必须包含 HTML 文件路径，否则报告为空 - 如果用了自定义规则集（如团队内部的
accessibility.json），需在 CI 中显式传参--config=./.htmlhintrc，否则 SonarQube 拿不到上下文
扫描速度慢、内存溢出怎么办
HTMLHint 默认单线程扫描，大项目（>500 个 HTML 文件）容易 OOM 或超时，尤其在 GitHub Actions 的 2GB 内存限制下。
- 加
--max-warnings=0关掉警告计数，减少内部状态维护开销 - 用
find . -name "*.html" -print0 | xargs -0 -P 4 -n 20 npx htmlhint手动并行，-P 4 表示最多 4 个进程，-n 20 表示每批处理 20 个文件 - 排除 node_modules 和 dist 目录：HTMLHint 不自动忽略这些，必须显式加
--exclude=node_modules/**,dist/** - 老旧版本（
htmlhint@0.15）有 V8 内存泄漏，升级到@latest（当前 0.16.2）可缓解，但无法根治——这时换用@html-eslint/cli更稳，它基于 Rust 解析器，内存占用低 40%
doctype-first 规则只检查文件开头是否声明 ，但它不会校验这个声明是否在真实渲染上下文中有效——比如模板引擎生成的片段 HTML（无 doctype）被插入到完整页面里，扫描通过，但实际运行时可能触发 Quirks Mode。这类问题只能靠运行时检测补位，静态扫描管不到。前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
