ctrl+shift+i(windows/linux)或cmd+shift+i(macos)调出内联定义浮层,显示函数/变量的声明结构(含参数、返回值等),不跳转、不切换文件,光标需落在符号名上,esc可关闭。

Ctrl+Shift+I 调出内联定义,不跳转就能看函数签名
想确认一个函数参数类型或返回值,又不想离开当前编辑位置?Ctrl+Shift+I(Windows/Linux)或 Cmd+Shift+I(macOS)直接弹出「Quick Definition」浮层,显示函数/变量的声明结构——包括参数名、类型、返回值、是否可选等,全部内联渲染,不新开标签页、不切换文件。
常见错误是把它和 Ctrl+Q 混用:Ctrl+Q 看的是 JSDoc 文档说明,而 Ctrl+Shift+I 看的是实际声明代码结构;如果函数没写类型注解、或来自未附带 .d.ts 的库,这里可能只显示 function xxx() 或 any,不是快捷键失效,是类型信息缺失。
- 光标必须落在符号名称上(比如
map而不是map(或.) - 对 TypeScript 项目效果最稳定;JS 项目需开启
Settings | Languages & Frameworks | JavaScript | Libraries中的类型声明加载 - 按
Esc可随时关闭浮层,不影响当前编辑流
Ctrl+Q 查文档失败?先检查三件事
Ctrl+Q 不弹窗,大概率不是快捷键被覆盖,而是触发条件没满足。它只对「有文档信息」的符号响应,且依赖 IDE 的索引就绪状态。
最容易被忽略的三个点:
- 符号本身无 JSDoc 或类型声明——比如自己写的空函数、或引用了没打包
@types的 npm 包 - 光标卡在括号、点号、分号等边界位置,而非标识符内部(例如
arr.map|()中的|在(上就不行,得移到map字母中间) - 右下角状态栏显示
Indexing…或Analyzing…,此时文档提取会延迟甚至静默失败;等待索引完成再试
若仍无效,按 Ctrl+Shift+A 输入 Quick Documentation,看右侧是否仍绑定为 Ctrl+Q;若显示为空或被改写,说明系统级工具(如 Raycast、输入法)劫持了组合键。
Markdown 预览不用双击,右键菜单藏了个关键选项
WebStorm 默认不通过双击打开浏览器预览 .md 文件,而是启用内置 Markdown Preview 面板。双击只打开源码编辑器,这是正常行为,不是 bug。
正确做法是:
- 右键点击
.md文件 → 选Open Preview(注意不是Open in Browser) - 若菜单里没有这项,进
Settings | Plugins,确保Markdown插件已启用并重启 - 更快速:按
Ctrl+Shift+P(或Cmd+Shift+P),输入Markdown Preview回车,面板即出现在右侧或底部
该面板实时渲染,支持表格、代码块、数学公式(需插件配置),但不执行 JS 脚本——这点和浏览器预览有本质区别,别指望它跑交互 demo。
Ctrl+Click 跳转定义 vs 快速预览:什么场景用哪个
Ctrl+Click(或 Cmd+Click)是强跳转,适合你确定要深入源码细节、修改实现逻辑时用;而 Ctrl+Shift+I 和 Ctrl+Q 是轻量预览,核心价值在于「不中断上下文」。
容易踩的坑:
- 在写新函数时频繁
Ctrl+Click进第三方库源码,结果陷在几十层嵌套里出不来——这时该用Ctrl+Shift+I看一眼参数就回来 - 误以为
Ctrl+Q能替代 API 文档网站,其实它只展示本地索引到的内容;像 React 的useState类型定义,若没装@types/react,Ctrl+Q就是空白 -
Ctrl+Shift+I不显示 JSDoc 注释,Ctrl+Q不显示完整类型签名——两者互补,不是二选一
真正高效的节奏是:先 Ctrl+Shift+I 确认结构 → 再 Ctrl+Q 看说明 → 仅当需要改实现时,才 Ctrl+Click 跳过去。这个顺序漏掉任何一环,都容易在信息过载里卡住。











