配置HTMLHint却发现它完全没反应？别急着卸载重装，问题大概率出在下面三个硬性条件上。首先，配置文件名称必须严格遵循.htmlhintrc（JSON格式）或.htmlhintrc.js（JS导出格式），拼写错误、多一个字符或少一个后缀都无法被识别。其次，这个文件必须放置在项目根目录，且不能被.gitignore或构建工具排除在外。最后，如果你用的是VS Code插件，记得重启窗口（不是重载），同时确认settings.json里已经开启了"html.validate.attributes": true。命令行执行时也要注意指定入口HTML路径，比如npx htmlhint src/index.html。
HTMLHint 配置不生效？检查这三处硬性条件
HTMLHint 并非装好就能自动运行的“开箱即用”工具，配置文件缺失、路径错误或规则未被激活，都会导致它毫无反馈。最常见的情况是 .htmlhintrc 文件名写错（比如写成 .htmlhint.json 或漏掉字母 r），或者配置文件被放在了项目根目录之外的其他位置。
- 必须使用标准文件名：
.htmlhintrc（JSON 格式）或.htmlhintrc.js（JS 导出格式），其他命名方式均不生效 - 文件必须置于项目根目录下，且不能被
.gitignore或构建工具忽略 - 命令行执行时需明确指定入口 HTML 文件路径，例如：
npx htmlhint src/index.html；若用 VS Code 插件，则需确认插件已启用且工作区已加载该配置
语义化标签误用：不是加了
不少开发者把 / 的页眉区域，而不是视觉上的装饰性容器。
必须包裹真正用于导航的链接集合，不能只是几个按钮或图标在整个文档中只能出现一次，且不应嵌套在或内部- 用
替代纯文本日期，机器可读性才真正生效
属性值不加引号？浏览器能容错，但构建工具会报错
写 
logo.png alt=公司标识 被当作一个整体字符串，导致资源路径失效或属性丢失。W3C 规范也明确要求所有属性值必须用引号包裹。
- 统一用双引号：
class="user-card"，而非单引号或不加引号 - 布尔属性也需显式赋值：
required="required"，而不是required（后者在某些校验工具中会触发警告） - 路径中的斜杠方向要一致：Windows 下写
./images/icon.svg，别混用反斜杠
响应式失效？问题常出在 @media 之前就崩了
很多人调试了半天 @media (max-width: 768px)，发现手机上样式依然错乱，最后才找到根本原因——HTML 结构本身存在嵌套错误。比如 里塞了 ，浏览器自动补全后 DOM 层级偏离预期，CSS 选择器压根没匹配到目标元素。
- 先用浏览器开发者工具的 Elements 面板，折叠查看 DOM 树是否“看起来像你写的那样”
- 再运行
npx htmlhint --config .htmlhintrc src/*.html，重点看attr-no-duplication、attr-value-not-empty、id-unique这类规则是否报错 - 最后才调试媒体查询——确保
viewportmeta 标签存在且配置正确：
工程化不是堆砌工具，而是让每行 HTML 都经得起验证、适配缩放和团队协作。最容易忽略的细节，其实是每次保存前手动运行一次 htmlhint，以及在 Elements 面板里多点两下“刷新后检查 DOM 实际结构”。
