容器中HTML校验应避免全量扫描，改用git diff筛选变更文件并显式指定路径，预编译规则、禁用动态require，使用轻量二进制+固定镜像层缓存，强制--format=unix确保CI解析准确。
容器化构建中做HTML质量校验，别硬套本地开发那套流程——htmlhint 启动慢、规则加载重、配置文件路径错位，是常见卡点。直接在CI里跑完整校验，往往拖慢构建30秒以上。
为什么 htmlhint 在容器里变慢
默认情况下，htmlhint 会递归扫描整个 src/ 或 public/ 目录，读取每个文件再逐行解析；容器环境缺少文件系统缓存，加上 node_modules 未复用、.htmlhintrc 路径未挂载，会导致重复解析和规则重载。
- 不指定
--files时，它可能扫到node_modules/下的 HTML 模板（比如某些 UI 库自带 demo） -
.htmlhintrc若放在子目录但未用--config显式指定，htmlhint会 fallback 到默认规则集，漏检关键项 - Docker 构建阶段若未
COPY .htmlhintrc .，或 COPY 顺序在npm install之后，配置根本没生效
只校验变更文件：用 git diff 提速 70%
CI 中真正需要检查的，只是本次 PR 或 commit 修改过的 HTML 文件。跳过全量扫描，能直接把校验时间压到 2 秒内。
- 在 CI 脚本中加一行：
git diff --name-only HEAD~1 -- '*.html' | xargs -r htmlhint --config .htmlhintrc - 如果用 GitHub Actions，可用
actions/checkout@v4的fetched-depth: 0确保有完整历史，否则HEAD~1失效 - 注意过滤掉生成文件：
git diff ... | grep -v 'dist/' | grep -v 'build/'
预编译规则 + 禁用动态 require
htmlhint 默认在运行时动态 require() 规则模块，每次启动都触发 Node.js 模块解析开销。容器里更明显。
立即学习“前端免费学习笔记（深入）”；
- 改用
htmlhint --format=unix --config .htmlhintrc src/**/*.html（显式指定路径，避免 glob 内部遍历） - 在
.htmlhintrc中禁用非必要规则，比如关掉attr-lowercase（若已用 Prettier 统一格式），保留tag-pair、alt-require、doctype-first这三类强校验项 - 不要用
"rules": { "attr-value-double-quotes": true }这种宽松写法——明确设为"attr-value-double-quotes": ["error", "double"]，避免运行时推导
镜像层缓存与二进制复用
每次构建都 npm install htmlhint -g，既慢又不可控。全局安装还容易因 npm 版本差异导致规则行为不一致。
- 改用轻量级二进制：Dockerfile 中用
curl -sL https://github.com/htmlhint/HTMLHint/releases/download/v0.16.1/htmlhint-linux-x64 -o /usr/local/bin/htmlhint && chmod +x /usr/local/bin/htmlhint - 把
.htmlhintrc和校验脚本（如lint-html.sh）一起 COPY 到镜像固定路径，避免挂载卷带来的路径不确定性 - 确保
htmlhint命令所在层在 Docker 缓存链靠前位置，避免因package.json变动导致该层失效
最易被忽略的一点：容器里没有终端颜色输出，htmlhint 默认格式（stylish）会降级成无结构文本，CI 解析失败。必须强制用 --format=unix，且确保错误行号能被 Git 工具（如 ReviewDog）正确提取——否则“校验通过”可能是假阳性。
