VSCode 中可通过快捷键(Option+F12)、右键菜单或命令面板(Cmd+Shift+P)调用“Peek Definition”功能原地查看符号定义;需安装对应语言扩展并启用语义分析支持。

如果您在使用 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(macOS)或 Ctrl + Shift + P(Windows/Linux)打开命令面板。
2、输入 Peek Definition 并回车。
3、若光标已位于有效符号上,预览即刻加载;否则提示“无法在当前位置执行”。
四、配置语言服务器启用高级 Peek 支持
部分语言(如 TypeScript、Python、Rust)需对应语言扩展提供语义分析能力,才能正确识别跨文件定义并呈现完整结构。
1、打开 VSCode 扩展市场,搜索并安装官方推荐的语言扩展(例如 “Python” 官方扩展或 “rust-analyzer”)。
2、确保扩展状态为启用,并在设置中确认 "editor.quickSuggestions" 设为 true。
3、重启 VSCode 或重新加载窗口(Cmd + Shift + P → Developer: Reload Window)以激活新配置。










