Peek 视图是VSCode内置的轻量级内联查看功能,支持在不跳转文件的前提下查看定义、引用、类型声明等内容,并可在弹出窗口中直接编辑并实时同步保存。

VSCode 的 Peek 视图让你在不跳转、不离开当前文件的前提下,快速查看定义、引用、类型声明等内容,还能直接在弹出的小窗口里编辑——改完保存,原位置自动同步更新。
什么是 Peek 视图
Peek 是 VSCode 内置的轻量级内联查看功能,按快捷键(如 Alt+F12 查看定义)后,代码下方会弹出一个半透明浮动面板,显示目标内容。它不是新标签页,也不打断你的编辑流,适合快速确认、小范围修改。
常用 Peek 操作与快捷键
这些操作都保持光标留在原处,Peek 窗口关闭后自动回到原来位置:
- 查看定义(Peek Definition):把光标放在函数/变量上,按 Alt+F12(Windows/Linux)或 ⌥+F12(macOS)
- 查看所有引用(Peek References):按 Shift+F12,列出项目中所有调用/使用该符号的位置
- 查看类型定义(Peek Type Definition):适用于 TypeScript 或支持类型推导的语言,快捷键同为 Alt+F12(部分语言默认绑定)
- 查看声明(Peek Declaration):对头文件、接口声明等特别有用,可通过命令面板搜索 “Peek Declaration” 调用
Peek 窗口里能编辑吗?怎么保存?
可以。Peek 窗口本质是一个可编辑的只读视图,但只要你做了修改,它会自动变为可写状态。改完后:
- 按 Ctrl+S(或 Cmd+S)保存,修改会实时同步回原文件
- 点击 Peek 窗口右上角 × 关闭,或按 Esc,改动仍保留(未保存前关闭会提示)
- 支持多光标、格式化、代码补全等常规编辑功能
注意:如果目标定义在只读文件(如 node_modules 中的库文件)里,Peek 默认禁用编辑;此时可右键选择 “Open Definition to the Side” 手动打开只读副本再处理。
提升效率的小技巧
- Peek 窗口支持滚动、折叠代码块(有折叠箭头时可点开)、甚至运行简单调试操作(如 hover 查看变量值)
- 连续按两次 Alt+F12 可在多个重载定义间切换(常见于 TS/JS 函数重载)
- 在 Peek 窗口中按 Ctrl+Click(或 Cmd+Click)可跳转到其中的其他符号定义,形成“嵌套 Peek”
- 在设置中搜索 “peek” 可调整动画时长、字体大小、是否启用预览模式等行为
基本上就这些。Peek 不复杂,但容易忽略它的编辑能力——善用它,能少开十几个标签页,思路也不容易断。










