直接禁用「Show quick documentation on mouse move」即可关闭鼠标悬停弹出文档窗，该选项位于Settings → Editor → General → Other，取消勾选后生效，不影响Ctrl+Q/Ctrl+J手动调用完整文档面板。
怎么关掉鼠标悬停就弹出的文档窗
直接禁用「Show quick documentation on mouse move」选项即可，这是唯一需要操作的开关。它控制所有语言（PHP/JS/TS/HTML）的悬停文档行为，和代码补全、跳转定义无关。
- 打开
Settings（Windows/Linux：Ctrl+Alt+S；macOS：Cmd+,） - 进入
Editor → General → Other - 取消勾选
Show quick documentation on mouse move - 点击
OK或Apply生效
关闭后，悬停函数、标签、属性时不会再自动弹出小窗，但 Ctrl+Q（Windows/Linux）或 Ctrl+J（macOS）仍可手动呼出完整文档面板。
为什么关了还偶尔弹出来
常见原因不是设置没生效，而是触发条件被误判——比如你正按住鼠标左键拖选代码，同时光标经过某个符号，WebStorm 会把这当作“悬停”并弹窗。这不是 Bug，是设计逻辑：只要鼠标在符号上停留且未移动，就满足触发条件。
- 检查是否开启了
Drag and drop editing（Settings → Editor → General → Editor Tabs → Enable drag-and-drop editing），开启时拖选过程更容易误触 - 确认没有第三方插件（如某些 Markdown 预览插件）劫持了悬停事件
- macOS 用户要额外检查系统级设置：
辅助功能 → 鼠标键 → 悬停点击若启用，会导致 IDE 认为每次悬停都是“准备点击”，从而提前触发文档弹出
关掉之后还想查文档怎么办
手动调用比自动弹更可控，尤其适合阅读长文档或带继承链的类方法：
-
Ctrl+Q（Windows/Linux）或Ctrl+J（macOS）：呼出可滚动、支持语法高亮、显示父类/接口方法的完整文档视图 -
Ctrl+Shift+I：快速查看定义（只显示声明位置，不带说明） - 对 HTML 标签或属性，
Ctrl+Q还会显示 MDN 兼容性摘要和弃用状态，比悬停窗信息更全
如果发现 Ctrl+Q 也空白或 loading，问题大概率出在 stubs 路径或 PHPDoc 格式，不是悬浮窗开关本身。
容易被忽略的细节
这个设置只影响「悬停弹窗」，不影响其他文档相关功能。比如：
- HTML 标签上的 MDN 提示仍可通过
Ctrl+Q查看，哪怕悬停已关闭 - PHPDoc 注释里的
@param、@return在参数提示（Parameter Info）中依然可用，只要开启了Show the parameter info popup - 关闭后，
Ctrl+Q呼出的文档面板右下角仍有「Open in Browser」链接，点开就是完整 MDN 页面
真正要留意的是：一旦关掉悬停，很多人会下意识反复尝试悬停，忘了快捷键的存在——这时候按一下 Ctrl+Q，往往比找设置更快。
