phpstorm 的 ctrl+q 查不到 index.html 文件文档，因它只解析光标下符号（如标签名）而非文件名；查 html 标签需光标落在标签名内、启用 web core 插件、文件类型为 html，且文档内容限于内置 dtd，不包含完整 mdn 信息。
PhpStorm 里按 Ctrl+Q 查不到 index.html 的标签文档？
因为 PhpStorm 的实时文档（Quick Documentation）不解析 HTML 文件本身，它查的是当前光标下符号的定义——而 index.html 是一个文件名，不是语言结构或函数。你真正想查的是 HTML 标签（比如 <div>、<code><script></script>）的语义、属性或浏览器支持情况。
光标停在 <input> 上按 Ctrl+Q 没反应？检查这几点
这是常见误操作：HTML 标签文档默认依赖内置的 Web Core 插件和正确的语言注入。没反应通常不是功能失效，而是环境未就绪：
- 确保已启用
Web Core插件（Settings → Plugins，搜索并勾选） -
index.html文件必须被识别为 HTML 类型——右下角状态栏应显示HTML，不是Text或Plain Text；若不对，右键文件 → Override File Type → HTML - 光标需严格落在开始标签内部（如
<input> 的 <code>input字符上），不能停在、<code>>或闭合标签上 - 首次调用可能延迟 1–2 秒，别急着连按
Ctrl+Q 查到的文档为什么只有基础属性，没有 MDN 链接或兼容性表格？
PhpStorm 自带的 HTML 文档来自其内置的 DTD 和少量 W3C 快照，不联网、不实时同步 MDN。它只提供最常用属性（如 id、class、src）和简单说明，不包含 autofocus 在 IE 中是否生效这类细节。
- 要查完整兼容性，直接在文档窗口点击右上角
Open in Browser按钮（小地球图标），它会跳转到本地缓存的 JetBrains Web Help 页面，内容比弹窗更全 - 更推荐做法：选中标签名（如
canvas），按Ctrl+Shift+A打开命令搜索，输入Open MDN Page（需提前安装MDN Docs插件） - 注意：
required这类布尔属性在 PhpStorm 文档里可能标为 “(empty)”，实际只需存在即生效，不用赋值
想让 <template></template> 或自定义元素也有文档提示？得手动配
原生 HTML5 标签有基础支持，但 <template></template>、<slot></slot> 或 Web Component 自定义标签默认无描述。这不是 bug，是设计使然——IDE 不预设所有扩展语义。
- 可手动添加注释增强提示：在
<template></template>开始标签上方加<!-- @htmltag template: A container for client-side templates -->，Ctrl+Q 就能读到这行 - 对自定义元素，建议在项目根目录建
web-types.json并声明tags，PhpStorm 会识别（需 Web Components 插件） - 别指望
<my-button></my-button>自动关联到组件源码——除非该标签在当前项目中有对应customElements.define()调用且路径可索引
真实项目里，HTML 标签的“文档”往往不在 IDE 里，而在团队的组件库文档页或 Storybook 中。PhpStorm 的 Ctrl+Q 是起点，不是终点。
