必须将html校验设为强制阻断环节,通过htmlhint配置5–8条团队级规则、ci拦截、husky+lint-staged预提交自动修复,并下沉w3c校验能力至编辑器与ci,辅以无术语、带上下文和模板的精准反馈,消除非前端人员修改html的技术门槛。

跨专业协作团队(如产品、设计、前端、测试甚至运营人员都可能修改HTML)无法靠个人自觉守住质量底线,必须把校验变成“不修复就卡住”的强制环节。
用 htmlhint 配置可落地的团队规则集
别直接套用默认规则——它会报几百个警告,新人直接放弃。从团队真实痛点出发,只开 5–8 条硬性规则:
-
"tagname-lowercase": true—— 强制小写,避免<div> 和 <code><div> 混用导致 Git 冲突 <li> <code>"attr-no-duplication": true—— 防止class="a" class="b"这类低级错误 -
"attr-req-value": ["img", "input"]—— 仅对img和input强制要求属性值(如alt、type),不一刀切 -
"head-title-only-in-head": true——<title></title>必须在里,否则 SEO 和标签页显示全崩 -
"attr-quote-style": "double"—— 统一用双引号,和 Prettier 格式化对齐,减少无意义 diff - 用
husky+lint-staged组合,在pre-commit钩子中跑htmlhint --fix -
--fix能自动补
规则写进 .htmlhintrc,放在项目根目录,所有成员 clone 即生效。CI 流程中加一行 npx htmlhint src/**/*.html,失败则阻断构建。
Git 提交前自动校验 + 一键修复,绕过人为疏漏
靠等 PR 时被发现太晚,问题已合入主干。必须在代码离开本地前拦截:











