ctrl+q 是 webstorm 查看快速文档的默认快捷键，光标停在有文档信息的符号内部时触发，显示签名、jsdoc 注释等；若无响应，常见原因包括符号无文档、光标位置不当或插件未就绪。
Ctrl+Q 是 WebStorm 查看快速文档的默认快捷键
光标停在任意符号（函数、类、方法、变量）上，按 Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS），就会在编辑器右侧浮出文档弹窗，显示其签名、JSDoc 注释、源码链接（如果可跳转）等。它不打开新标签页，也不依赖外部浏览器，响应快、上下文紧。
为什么 Ctrl+Q 有时没反应？常见三类原因
不是快捷键失效，而是触发条件未满足：
-
Ctrl+Q只对「有文档信息」的符号生效——比如你写了个自定义空函数没写 JSDoc，或引用了未附带类型声明的第三方库，弹窗可能只显示function xxx()或空白 - 光标必须落在符号「内部」，不能只贴着括号或点号；例如
arr.map(时把光标放在map上才有效，放在(上无效 - 部分插件（如某些语言服务或 LSP 客户端）未就绪时，文档提取会延迟甚至失败；可观察右下角状态栏是否显示 “Indexing…” 或 “Analyzing…”
替代方案：当 Ctrl+Q 不够用时该用什么
快速文档是轻量级预览，真要查全貌或跳转源码，得换方式：
- 按
Ctrl+Click（或Cmd+Click）直接跳转到定义——比看文档更进一步，适合想确认实现细节时 - 按
Ctrl+Shift+I（Windows/Linux）或Cmd+Shift+I（macOS）呼出「Quick Definition」弹窗，显示内联定义（含类型、参数），比Ctrl+Q更侧重结构而非说明文字 - 如果文档里有 @link 或 {@see} 标签但点不动，说明当前项目没启用 JSDoc 解析支持——检查
Settings | Languages & Frameworks | JavaScript | Libraries是否已加载对应类型声明
自定义或修复 Ctrl+Q 绑定前，先确认它没被系统吃掉
尤其 macOS 用户，Cmd+Q 默认是「退出应用」，WebStorm 会自动规避这个冲突，改用 Cmd+J 或保留 Cmd+Q 仅在编辑器聚焦时生效。但如果你装了 Alfred、Raycast 或输入法（如鼠须管），它们可能劫持了组合键且不提示。验证方式很简单：按下 Ctrl+Shift+A → 输入 Quick Documentation，看右侧是否仍显示 Ctrl+Q；如果不显示，说明已被覆盖，点击铅笔图标重绑即可。
