WebStorm悬停默认只显示PHPDoc或简要声明，要看实际源码需用Ctrl+Q（Windows/Linux）或Ctrl+J（macOS）调出完整文档面板；空白或“Loading…”多因stubs未加载、PHPDoc缺失、缓存损坏、系统悬停拦截或源码路径未被索引所致。

WebStorm 默认悬停显示的是 PHPDoc 或简要声明，不是源码。要看到实际源码（比如函数体、类定义），得用 Ctrl+Q 手动触发完整文档面板，并确保对应 stubs 或源码已正确索引。

为什么悬停只显示“Loading…”或空白？

常见原因不是设置没开，而是底层内容不可达：

• 项目里没加载对应语言的 stubs（如 PHP 的 phpstorm-stubs、JavaScript 的 @types 包）
• PHPDoc 注释缺失或格式不规范（例如缺少 /** */ 包裹、参数未用 @param 标明）
• 缓存损坏：File → Invalidate Caches and Restart → Invalidate and Restart
• macOS 用户若开启了系统级“悬停点击”，会拦截 WebStorm 的悬停事件，导致弹窗不出现

启用悬停文档并提升源码可见性

仅开启“Show quick documentation on mouse move”还不够，关键在内容来源：

WebStorm Linux版

WebStorm 2026.2 Linux tar.gz 安装包，适合在 Linux 桌面环境中搭建现代前端开发与调试工作流。

下载

• Settings → Editor → General → Other → 勾选 Show quick documentation on mouse move，延迟建议设为 400 ms
• PHP 项目需确认已配置 PHP Language Level 和 CLI interpreter，且插件（如 Laravel Plugin）已启用
• JavaScript/TypeScript 项目应安装 @types 包，并在 Settings → Languages & Frameworks → JavaScript → Libraries 中确认类型库已识别
• 对第三方库，WebStorm 依赖 node_modules 或 vendor 下的真实源码路径；若只有编译后代码（如 dist/），悬停无法还原原始实现

Ctrl+Q 是看源码最可靠的入口

鼠标悬停本身受限于性能与展示空间，真正想看函数体、return 逻辑或 if 分支，必须用快捷键：

• 光标停在方法名上，按 Ctrl+Q（Windows/Linux）或 Ctrl+J（macOS）
• 弹出的面板支持滚动、语法高亮，甚至能跳转到定义（Ctrl+B）
• 如果仍为空白，右键该方法 → Go to → Declaration or Usages，确认是否真能定位到源文件；不能说明索引失败或路径未纳入项目范围

悬停显示源码不是“开关一开就成”的功能，它高度依赖项目结构、类型定义完整性以及 WebStorm 对源路径的实际解析能力。别迷信鼠标悬停，Ctrl+Q 才是日常开发中真正能稳定展开源码的手段。