VSCode中可使用Command+Click跳转定义、Cmd+Shift+O搜索符号、F2语义重命名、右键“重命名符号”,JS/TS项目需配置jsconfig.json或tsconfig.json启用语义支持。

如果您在使用 VSCode 编辑代码时希望快速跳转到某个符号定义位置,或对变量、函数等标识符进行安全重命名,则需依赖其内置的符号导航与语义重命名能力。以下是实现该目标的具体操作方式:
本文运行环境:MacBook Pro,macOS Sequoia。
一、使用 Command+Click(macOS)或 Ctrl+Click(Windows/Linux)跳转到符号定义
此方法利用 VSCode 的语言服务器协议(LSP)支持,在光标悬停于符号上时触发快速定义跳转。它适用于已安装对应语言扩展并启用 LSP 的项目。
1、将光标置于目标符号(如函数名、类名、变量名)上。
2、按住 Command 键(macOS) 并单击该符号。
3、编辑器将自动跳转至该符号的定义位置;若存在多个定义,会弹出列表供选择。
二、通过 Ctrl+Shift+O(Windows/Linux)或 Cmd+Shift+O(macOS)打开符号大纲
该快捷键调用“转到符号”面板,允许用户按名称模糊搜索当前文件或工作区中的符号,包括类、方法、属性等结构化元素。
1、按下 Cmd+Shift+O(macOS) 或 Ctrl+Shift+O(Windows/Linux)。
2、在弹出的输入框中键入符号名称关键词。
3、使用方向键选择目标条目,按 Enter 确认跳转。
三、使用 F2 键执行语义重命名
VSCode 的重命名功能基于语言服务提供的语义分析,可跨文件更新所有引用,前提是语言扩展支持且项目配置正确(如 tsconfig.json 或 jsconfig.json 已启用)。
1、将光标置于待重命名的符号上。
2、按下 F2 键。
3、在顶部编辑栏中输入新名称,按 Enter 提交更改。
四、通过右键菜单选择“重命名符号”
当快捷键不可用或用户偏好图形界面操作时,可通过上下文菜单触发相同语义重命名流程,底层逻辑与 F2 一致。
1、右键单击目标符号。
2、在弹出菜单中选择 “重命名符号” 选项。
3、在编辑框中输入新名称后按 Enter。
五、启用 JavaScript/TypeScript 的自动重命名配置
对于 JS/TS 项目,若重命名未生效,可能因未启用语义检查。需确保项目根目录下存在有效的 jsconfig.json 或 tsconfig.json,并开启 allowSyntheticDefaultImports 和 resolveJsonModule 等基础项。
1、在项目根目录创建 jsconfig.json 文件(JS 项目)或 tsconfig.json(TS 项目)。
2、写入包含 "compilerOptions": { "allowSyntheticDefaultImports": true } 的最小有效配置。
3、重启 VSCode 窗口使配置生效。










