默认不开启，需手动开启“Show quick documentation on mouse move”：Settings → Editor → General → Other → 勾选该选项，并建议将延迟调至300–400ms。
默认不开启，必须手动打开“Show quick documentation on mouse move”才能悬停出文档。 否则光标移过去什么都不会弹，不是插件问题，也不是注释写得不对——根本没启用这个功能。
怎么开启悬停文档提示
路径是：Settings → Editor → General → Other，找到 Show quick documentation on mouse move 并勾选。下方的延迟时间（default 500ms）建议调成 300–400ms：太短容易误触发，太长会感觉“卡一下才出来”。这个设置对 HTML 标签、JS 函数、CSS 属性、JSDoc 注释都生效。
为什么悬停后只显示 “Loading…” 或空白
常见原因有三个，按优先级排查：
-
Stub路径未配置或指向了过时版本（比如还在用phpstorm-stubs@1.0）；正确做法是去Settings → Languages & Frameworks → JavaScript → Libraries → Download点“Download”获取最新 stubs - JSDoc 注释格式不合法：必须是
/** ... */（开头两个星号），/* ... */或/**...*/（无换行）不会被识别 - 缓存损坏：执行
File → Invalidate Caches and Restart → Just Restart，别跳过这步——很多“突然不显示”都是缓存解析中断导致的
悬停窗太小、不能滚动、看不到继承链怎么办
悬停窗就是设计成轻量预览用的，它不支持滚动、不显示父类方法、也不渲染 Markdown 格式。真要查完整文档，请用快捷键：
- Windows/Linux：
Ctrl+Q - macOS：
Ctrl+J
这个面板可滚动、带语法高亮、显示 @extends/@implements 关系，还能点击跳转到源码定义。日常开发中，Ctrl+Q 的使用频率远高于悬停——尤其看第三方库方法时，悬停几乎没信息量。
真正容易被忽略的是：HTML 标签和属性的文档来自 MDN，但只在你鼠标悬停在 <div> 或 <code>flex-wrap 这类真实标签/属性上才触发；如果悬停在字符串字面量里（比如 const tag = "div"），不会弹出任何内容。
