### [HTML 编辑器波浪线误报的排查清单](https://www.huociguo.com/article/1861)
**Published:** 2026-10-04T03:22:49
**Author:** 米了
**Excerpt:** 🔍 编辑器里的红绿波浪线，九成是校验误报，并非代码真错。按顺序排查，比盲目改代码省事。第一步，悬停波浪线看提示…
🔍 编辑器里的红绿波浪线，九成是校验误报，并非代码真错。按顺序排查，比盲目改代码省事。
第一步，悬停波浪线看提示来源。常见关键词：`htmlhint` 属 HTML 静态校验，`cSpell` 是拼写检查，`Vetur` 多出现在 Vue 模板。先认来源，再谈处理。
波浪线来源不同，处理方式不同
第二步，核对文件关联。HTML 片段被当成普通文本时，校验器全面报警。把语言模式切到 HTML 即可消掉大半。
第三步，针对性关规则。htmlhint 可在 `.htmlhintrc` 里关掉 `doctype-first`、`attr-lowercase` 等不适用的项；cSpell 把专有名词加进词典。⚠️ 不要全局禁用校验，只关误报项，保留真正有用的检查。
其余情况，重启语言服务或重载窗口能解决缓存导致的假报错。
**Tags:** htmlhint 校验, VSCode HTML 提示, 校验规则配置, 编辑器波浪线, 语法误报
**Categories:** HTML5
---