Peek Definition功能可通过快捷键、右键菜单、语言服务器配置、自定义键绑定及设置开关五种方式实现:macOS下用Option+F12,右键选Peek Definition,确保语言服务器正常,可自定义快捷键,且需启用Peek Widget和Hover。

如果您在VSCode中查看某段代码时,希望快速查看某个函数或变量的定义位置而不离开当前文件,则可能是由于未正确触发或配置Peek Definition功能。以下是实现此功能的多种方式:
本文运行环境:MacBook Air,macOS Sequoia。
一、使用快捷键触发Peek Definition
该方法通过键盘组合直接唤出定义预览窗口,无需鼠标操作,适合高频代码浏览场景。
1、将光标置于目标函数名、类名或变量名上。
2、按下 Option + F12(macOS)或 Alt + F12(Windows/Linux)。
3、定义内容将以悬浮面板形式出现在当前编辑器下方,支持滚动与语法高亮。
二、通过右键菜单调用Peek Definition
该方法适用于不熟悉快捷键或需要明确操作路径的用户,提供可视化入口。
1、右键单击目标标识符(如函数调用处)。
2、在弹出菜单中选择 Peek Definition 选项。
3、悬浮面板立即展开,显示对应定义源码片段。
三、启用并验证语言服务器支持
Peek Definition依赖于已激活且正常工作的语言服务器,若功能失效,需确认后端服务状态。
1、打开命令面板(Cmd + Shift + P)。
2、输入并执行 Developer: Toggle Developer Tools。
3、切换到 Console 标签页,检查是否存在 Language Server is not available 类错误提示。
4、如存在,前往 Extensions 视图安装对应语言扩展(如 Python、TypeScript),并重启 VSCode 窗口。
四、自定义快捷键绑定
当默认快捷键与其他应用冲突或不符合个人习惯时,可通过键盘快捷方式设置进行覆盖。
1、按下 Cmd + K,松开后按 Cmd + S 打开键盘快捷方式设置。
2、在搜索框中输入 editor.action.peekDefinition。
3、点击加号图标添加新快捷键,输入期望组合(如 Ctrl + Option + D)并确认。
五、检查设置中的Peek行为开关
VSCode允许禁用所有Peek类功能以提升性能或简化界面,需确保相关配置处于启用状态。
1、打开设置界面(Cmd + ,)。
2、搜索关键词 peek。
3、确认 Editor > Peek Widget: Enabled 复选框已被勾选。
4、同时检查 Editor > Hover: Enabled 是否开启,因部分语言需悬停信息作为Peek前置条件。










