ctrl+q 是 webstorm 查看快速文档的默认快捷键，仅对带 jsdoc、类型声明或标准 api 的符号生效；光标须置于符号内部，且语言服务就绪，否则弹窗空白或不出现。
Ctrl+Q 是 WebStorm 查看快速文档的默认快捷键，但不是所有符号按了都有反应——它只对「有文档信息」的符号生效，比如带 JSDoc 注释的函数、有类型声明的第三方库 API，或标准 JS 对象（Array.prototype.map 这类）。没写注释、没加载类型定义、光标位置不对，都会导致弹窗空白或直接不出现。
为什么 Ctrl+Q 按了没反应？
常见三类原因不是快捷键坏了，而是触发条件不满足：
-
Ctrl+Q只响应「已附带文档信息」的符号：你自己写的空函数没写/** */，或者引用了没提供@types的 npm 包（比如某些老版本lodash），弹窗就只能显示function xxx()或干脆空白 - 光标必须落在符号「内部」：比如想查
arr.map()，光标得停在map上，停在(、.或arr后面都不行 - 语言服务未就绪：右下角状态栏显示
Indexing...或Analyzing...时，Ctrl+Q可能延迟甚至失败；刚打开大项目头几秒尤其明显
Ctrl+Q 和 Ctrl+Click 怎么选？
两者目标不同，别混用：
-
Ctrl+Q是轻量预览：适合快速确认参数顺序、返回值类型、是否可选——比如看到@param {string} [name]就知道name是可选字符串 -
Ctrl+Click（或Cmd+Click）是跳转定义：适合你想看实现细节、进源码改逻辑，或验证某方法是不是被重写了 - 如果文档里有
@link或{@see}但点不动，说明项目没启用JSDoc解析支持——检查Settings | Languages & Frameworks | JavaScript | Libraries是否已加载对应类型声明
macOS 用户特别注意：Cmd+Q 被系统劫持怎么办？
WebStorm 默认会规避 macOS 的「退出应用」冲突，但第三方工具（Alfred、Raycast、鼠须管等）可能悄悄吃掉组合键：
- 验证方式：按
Ctrl+Shift+A→ 输入Quick Documentation→ 看右侧是否仍显示Cmd+Q - 如果不显示，说明已被覆盖；点击铅笔图标重绑即可
- 别直接改系统快捷键设置，WebStorm 内部重绑更可靠——路径是
Settings | Keymap | Other | Quick Documentation
真正容易被忽略的是：文档弹窗里的超链接（比如 @link）只有在 IDE 已索引到对应源码路径时才可点击；如果项目结构复杂、依赖嵌套深，或者用了 pnpm 的硬链接，Ctrl+Q 显示的链接大概率是灰色不可点的——这时候就得切到 Ctrl+Shift+I（Quick Definition）看内联结构，或手动去 node_modules 里翻 index.d.ts。
