HTMLHint 必须本地安装且配置文件为 .htmlhintrc，VS Code 插件仅识别项目级 htmlhint 和纯 JSON 格式配置；需确保文件语言模式为 HTML，禁用冲突 lint 插件以显示提示。
HTMLHint 必须本地安装，全局安装会失效
VS Code 里装了 HTMLHint 插件但没反应？大概率是你用了 npm install -g htmlhint。插件只认项目级的本地安装，全局命令行能跑，但编辑器里不触发校验。
- 进项目根目录执行：
npm install htmlhint --save-dev - 确保
node_modules/.bin/htmlhint存在（Windows 下是.cmd文件） - 插件启动时会自动探测本地
htmlhint可执行路径，找不到就静默退出 - 如果项目用 pnpm 或 yarn，也得用对应包管理器安装，不能混用
配置文件名必须是 .htmlhintrc，且格式严格
插件只识别 .htmlhintrc（带点），htmlhint.json 或 .htmlhintrc.json 都无效。内容必须是纯 JSON，不能有注释、尾逗号或单引号。
- 推荐最小可用配置：
{ "tag-pair": true, "attr-value-double-quotes": true, "doctype-first": true } - 规则名大小写敏感，比如
id-class-value不是ID-Class-Value - 如果项目里有多个 HTML 目录，把
.htmlhintrc放在最外层，它会递归生效
Live Server 和 HTMLHint 不冲突，但别开错文件类型
HTMLHint 默认只对 .html 文件生效，如果你右键用 Live Server 打开的是 index.htm 或 template.jade，它根本不会扫描——连提示都不会出现。
- 检查当前文件右下角语言模式是否显示
HTML（不是Plain Text或PHP） - 手动切换：Ctrl+Shift+P →
Change Language Mode→ 选HTML -
Live Server启动后页面地址是http://127.0.0.1:5500/xxx.html，不是file://协议，这点不影响 HTMLHint
错误提示不显示？先关掉其他 lint 插件
VS Code 里同时装了 ESLint、SonarLint、Error Lens，它们可能抢占诊断通道，导致 HTMLHint 的 warning 被吞掉或压低优先级。
立即学习“前端免费学习笔记（深入）”；
- 临时禁用其他 lint 类插件，只留
HTMLHint，看提示是否恢复 - 打开命令面板（Ctrl+Shift+P），运行
Developer: Toggle Developer Tools，切到 Console 标签页，搜htmlhint看有没有报路径或解析错误 - 如果某行同时有多个问题，HTMLHint 默认只显示第一个，不是漏检，是设计如此
.htmlhintrc 是否在正确位置、htmlhint 是否被本地安装、当前文件是否被识别为 HTML 类型——三者缺一不可。 
