必须手动启用“show quick documentation on mouse move”才能触发悬停文档，路径为settings → editor → general → other；该功能控制所有语言悬停行为，延迟建议设为400ms；html标签悬停仅对真实标签/属性生效，字符串或自定义组件名不触发；真正查源码应使用ctrl+q/cmd+j。
必须手动开启“Show quick documentation on mouse move”，否则悬停什么都不会弹出来——不是注释写得不对，也不是插件没装好，就是功能根本没启用。
怎么打开悬停文档功能
路径是：Settings → Editor → General → Other，找到 Show quick documentation on mouse move 并勾选。这个开关控制所有语言的悬停行为：JS 函数、CSS 属性、HTML 标签、Vue 指令都靠它触发。
下方的延迟时间（默认 500ms）建议调成 400ms：
- 太短（如 100ms）容易在移动光标时误弹，干扰书写节奏
- 太长（如 800ms）会感觉“卡一下才出来”，失去即时反馈感
悬停只显示 “Loading…” 或空白的常见原因
这不是设置问题，而是内容加载失败。按优先级排查：
-
Stub路径未配置或指向旧版本（比如还在用phpstorm-stubs@1.0）：去Settings → Languages & Frameworks → JavaScript → Libraries，点Download获取最新 stubs - JSDoc 注释格式不合法：必须是
/** */（开头两个星号），/* */或/***/（无换行）不会被识别 - 缓存损坏：执行
File → Invalidate Caches and Restart → Just Restart，别跳过这步——很多“突然不显示”都是缓存解析中断导致的
为什么 HTML 标签悬停没反应
WebStorm 的 HTML 文档来自 MDN，但只在真实标签/属性上生效：
- 悬停在
<div> 或 <code>flex-wrap上 → 会弹出兼容性、弃用状态、MDN 摘要 - 悬停在字符串字面量里，比如
const tag = "div"→ 完全不触发，IDE 不认为这是语义化 HTML - 悬停在自定义组件名（如
<mybutton></mybutton>）上 → 若未配置 Vue/React 插件或类型定义，也大概率空白 -
Ctrl+Q（Windows/Linux）或Cmd+J（macOS）才是稳定查看源码的入口 - 该面板可滚动、带语法高亮、显示
@extends/@implements关系，还能点击跳转到定义 - 如果
Ctrl+Q也空白，说明源码路径没被索引、@types没装、或项目处于安全模式（外部导入未信任）
真正看源码别靠悬停，用 Ctrl+Q
悬停窗是轻量预览设计，不支持滚动、不显示继承链、不渲染 Markdown，也看不到函数体逻辑。日常开发中：
悬停文档的可靠性高度依赖项目结构和类型定义完整性，别把它当主力工具——Ctrl+Q 才是每天必按的那一下。
