phpstorm 默认不标出index.html标签错误，因将其视为静态资源而非需验证html；需在settings > editor > inspections中启用html相关检查项，并确认文件类型为html（右下角显示）。
PhpStorm 为什么没标出 index.html 里的标签错误？
默认情况下，PhpStorm 不会主动对纯 HTML 文件启用严格语法检查——它把 index.html 当作静态资源处理，除非你明确告诉它“这是需要验证的 HTML”。常见现象包括：<div> 漏闭合、<code><img> 缺 src、属性值没加引号，这些都不会被标红或提示。
解决方法很简单：打开 Settings > Editor > Inspections，在搜索框输入 HTML，找到 HTML > Unknown HTML tag/attribute 和 HTML > Invalid markup，确保它们已勾选。更重要的是，确认当前文件的「file type」是 HTML 而非 Plain Text（右下角状态栏查看，点开可切换）。
如何让 PhpStorm 报出 <input type="email"> 缺 required 这类语义错误？
这类不是语法错误，而是 W3C 推荐的可访问性/表单规范问题，PhpStorm 默认不检查。你需要手动启用 HTML > Accessibility 类别下的检查项，比如：Form field has no associated label、Input element with type="email" should have required attribute if mandatory。
- 这些检查依赖于你是否启用了
HTML5文档类型声明 —— 确保index.html顶部有 - 部分规则（如
label关联）只在元素有id且label[for]匹配时才生效，空for值或 ID 冲突会导致误报 - 若项目用 Vue 或 React 混写 HTML，建议关闭
HTML > Template language injection相关提示，否则会干扰原生 HTML 验证
index.html 引入了外部 JS，但 PhpStorm 提示 Unresolved variable 怎么办？
这不是 HTML 语法错误，但常被误认为是验证问题。PhpStorm 在解析 HTML 时，对 <script src="..."></script> 中的全局变量不会自动索引，所以你在内联 <script></script> 里调用 myFunction() 就会报 Unresolved variable 'myFunction'。
修复方式分两种：
- 如果 JS 文件就在项目中：右键该 JS 文件 →
Mark as > JavaScript library，或把它加到Settings > Languages & Frameworks > JavaScript > Libraries里 - 如果是 CDN（如
https://cdn.jsdelivr.net/npm/vue@3）：用<script></script>块加 JSDoc 注释临时声明，例如/** @type {Vue} */ const app = Vue.createApp(...) - 不要依赖“自动下载源码”功能——它常失败且污染项目，手动管理更可控
为什么改完 index.html 后，PhpStorm 的实时校验有时不更新？
PhpStorm 的 HTML 检查是基于缓存的 AST（抽象语法树），不是每次按键都重解析。最常见卡顿场景：刚从其他编辑器粘贴大段 HTML、用正则批量替换后、或文件编码被意外改成 GBK（而 PhpStorm 默认按 UTF-8 解析）。
强制刷新验证的实操步骤：
- 按
Ctrl + Shift + O（Windows/Linux）或Cmd + Shift + O（macOS）触发「Optimize Imports」，这会顺带重建 HTML 结构缓存 - 右键文件 →
Reload from Disk，尤其当你用脚本修改了文件但没通过 PhpStorm 保存时 - 检查右下角编码显示，若不是
UTF-8，点击切换并选择Convert（不是Reload），否则中文注释可能触发乱码相关误报
真正容易被忽略的是：PhpStorm 对 HTML 的验证深度受 Settings > Languages & Frameworks > HTML > Version 控制。设成 HTML5 才能启用自定义数据属性、语义化标签等全部检查；设成 HTML4 就连 <main></main> 都会被标为未知标签。
