VSCode 快捷键大全速查表 - 50+ 常用快捷键与配置
VSCode 最值钱的是把重构、符号跳转、多光标这些重操作都变成纯键盘动作,让写代码的精力留在逻辑上而不是鼠标移动上。本表按"通用 → 编辑 → 导航 → 重构/调试 → Git"的工作流组织,每条同时给出 macOS 与 Win/Linux 两套键位,并点出两平台差异(Cmd 对应 Ctrl、Option 对应 Alt)。想少碰鼠标做重命名、跳定义、多选批量改,从命令面板与编辑这两组开始练收益最大;在多人/跨平台协作时,也能快速对齐键位说明。读完能按工作流替代鼠标完成多数重构与导航操作。
典型使用场景
面向把 VS Code 当主力编辑器的人:把日常最高频的操作从鼠标挪到键盘。真正拉开效率差距的不是记快捷键本身,而是「命令面板 + 全局重构 + 多光标」这三组——命令面板让你不必记任何快捷键,F2 重命名能正确改掉所有引用,Option+Enter 多光标让批量编辑变成一次操作。本表按编辑、导航、重构调试、Git、搜索五组组织,Windows/Linux 把 Cmd 换成 Ctrl 即可。
通用 General 7
Cmd+Shift+PCtrl+Shift+PCmd+PCmd+,Cmd+Shift+XCmd+BCmd+`编辑 Editing 9
Option+↑/↓Shift+Option+↑/↓Cmd+LCmd+DCmd+Shift+LOption+ClickCmd+/Cmd+Option+[Cmd+Option+]重构与调试 8
F2Cmd+Shift+RF5F9F10F11Cmd+Shift+FCmd+Shift+HGit 集成 Git Integration 5
Cmd+Shift+GCmd+EnterCtrl+Shift+G BCmd+Shift+P > Git: PullCmd+Shift+P > Git: Push视图与面板 Views 4
Cmd+Shift+ECmd+Shift+DCmd+JCmd+K Z配置文件 Config Files 4
settings.jsonlaunch.jsontasks.jsonkeybindings.json搜索 Search 4
Cmd+F / Ctrl+FOption+Cmd+F / Ctrl+HCmd+Shift+H / Ctrl+Shift+HOption+Enter / Alt+Enter窗口与终端 Windows & Terminal 8
Cmd+\ / Ctrl+\Cmd+1 / Ctrl+1Cmd+2 / Ctrl+2Ctrl+` / Ctrl+`Ctrl+Shift+` / Ctrl+Shift+`Cmd+K / Ctrl+KCmd+K W / Ctrl+K WCmd+K F / Ctrl+K F参数矩阵
| 参数 | 作用 | 示例 |
|---|---|---|
Cmd+Shift+P | 命令面板,输入关键字调起任意命令 | Cmd+Shift+P → "Git: Pull" |
Cmd+P | 快速打开文件(模糊匹配路径) | Cmd+P → src/utils |
Cmd+D | 选中下一个相同内容,连续按形成多光标 | 连按 Cmd+D 选中多处相同文本 |
Option+Enter | 选中所有查找匹配项,批量替换 | Cmd+F 搜索后 Option+Enter 全选 |
F2 | 重命名符号,自动改所有引用 | 光标置于符号上按 F2 |
Shift+F12 | 查看所有引用,重构前先看波及范围 | Shift+F12 → References |
F12 / Cmd+Click | 跳转到定义 | F12 |
Cmd+T | 按符号跳转(函数 / 类 / 常量) | Cmd+T → useUser |
Cmd+/ | 切换行注释 | Cmd+/ |
Cmd+B | 切换侧边栏 | Cmd+B |
Cmd+Shift+G | 打开源代码管理面板 | Cmd+Shift+G |
Cmd+K Z | 禅模式,全屏无干扰 | Cmd+K Z |
易错点与避坑指南
现象快捷键按下无反应,换了键盘布局后全部失效。
原因系统输入法或键盘映射拦截了组合键。
处置在 keybindings.json 里查是否被覆盖;macOS 注意系统快捷键优先级高于 VS Code。
现象Cmd+D 选中多处后误改了不该改的地方。
原因连按次数超过预期,范围扩散到全文件。
处置先按 Esc 取消多光标;批量操作前用 Cmd+Shift+L 精确选中所有匹配。
现象F2 重命名后部分引用没被改到,运行时报未定义。
原因该引用在动态构造或跨语言文件里,静态分析找不到。
处置重命名前先 Shift+F12 看所有引用,对可疑位置手工核对。
现象集成终端里 Cmd+K 无效(想清屏却删掉了行)。
原因焦点在终端时,快捷键语义被终端接管。
处置先确认焦点位置;Cmd+K 仅在终端聚焦时才是清屏。
现象改动后 Git 面板显示文件多了很多行变更,实际只改了几行。
原因行尾符(CRLF/LF)被整体转换。
处置在 settings.json 设 "files.eol": "\n" 并用 files.trimTrailingWhitespace 统一处理。
现象打开的文件夹不对,或「打开文件夹」后工作区变成空。
原因用「打开文件」而非「打开文件夹」,工作区上下文未建立,搜索与 Git 功能因此失效。
处置File → Open Folder 重新打开目录根部,底部状态栏应显示工作区名称。
排障路径
1不知道某个功能对应哪个命令
Cmd+Shift+P直接搜功能名(如 "format document"),不必记快捷键。
2重构前先确认波及范围
Shift+F12列出所有引用位置,先看一遍再按 F2 重命名。
3批量修改所有匹配项
Cmd+Shift+L比连按 Cmd+D 更可控;或 Cmd+F 后 Option+Enter 全选匹配。
4自定义快捷键
Cmd+Shift+P → "Preferences: Open Keyboard Shortcuts (JSON)"在 keybindings.json 中写 {"key": "...", "command": "..."} 覆盖默认绑定。
5查看某行号并跳转
Cmd+G输入行号直接跳转;Ctrl+- 返回上一个位置。
命令示例
重命名一个符号的所有引用
F2光标放在标识符上按 F2,输入新名回车,所有引用(含跨文件)一次更新,优于手写全局替换。
选中所有相同内容后批量修改
Cmd+Shift+L / Ctrl+Shift+L先选中一个词,再按此键选中全文所有相同词,随后输入即同时替换,处理重复出现的变量/硬编码值最顺手。
跳到一个符号的所有引用
Shift+F12列出当前符号的所有引用并逐个跳转/预览,重构前先扫一遍,确认改动波及范围。
常见坑与注意事项
- macOS 与 Win/Linux 键位有系统性差异:Cmd↔Ctrl、Option↔Alt,跨平台阅读本表时先确认你当前用的系统是哪套。
- F2 重命名依赖语言服务器的索引,首次打开大项目或刚装扩展时可能提示索引中,先等右下角加载完成再操作。
- Cmd/Ctrl+Shift+L 会选中所有相同文本,若文本恰好是通用子串(如 i、result),会误伤大片区域,改前先确认选中集合。
- F5 仍沿用用户键位绑定,若你自定义过快捷键,以 keybindings.json 为准,本表为默认键位。
- 同一动作在远程 SSH/容器窗口里语义一致但可能受插件影响,若快捷键不生效优先查扩展冲突而非怀疑键位表。
提示
- Cmd+D 连续按可以依次选中所有相同文本,批量修改比正则更直观。
- Option+Click 多光标模式适合在多处同时输入,比如给多行加前缀。
- 自定义快捷键:Cmd+K Cmd+S 打开键盘快捷方式可视化编辑。
常见问题
vscode 里忘了快捷键怎么办?
随时按 Ctrl+Shift+P(macOS 用 Cmd+Shift+P)打开命令面板,输入中英文动作名就能执行任意命令,这是最稳妥的入口;每条命令旁也会显示默认快捷键。要改键位可用 Ctrl+K Ctrl+S 打开键盘快捷方式。
vscode 怎么用多光标同时批量编辑?
Windows/Linux 按住 Alt + 鼠标左键点选即可添加光标,macOS 用 Option。选中一段文本后按 Ctrl+D(Cmd+D)逐个添加下一个匹配,按 Ctrl+Shift+L(Cmd+Shift+L)全选所有匹配,按 Alt+↑/↓ 可整行上下移动。
vscode 的配置存在哪里,怎么在不同电脑同步?
用户设置写在 settings.json(Ctrl+, 打开后可切到文件),还有 keybindings.json 放键位、snippets 目录放代码片段。用官方 Settings Sync 登录账号即可跨设备同步这些配置;也可以手动把 settings.json 纳入自己的 dotfiles 仓库管理。
vscode 里怎么一次重命名所有引用?
把光标放在变量或函数名上按 F2,会同时重命名该符号所有作用域内的引用,并自动避开字符串和注释里的同名字面文本。它是基于语言服务识别的,跨文件、跨语言都可靠,比手动查找替换安全得多。
vscode 的 macOS 键位和 Windows 差在哪?
主要差异是 macOS 的 Cmd 对应 Windows/Linux 的 Ctrl,Option 对应 Alt,例如复制粘贴是 Cmd+C / Ctrl+C、光标到行首是 Cmd+← / Home。其余大部分快捷键布局一致。需要的话可在键盘快捷方式里给个别命令单独配两套键位。
由 巧匠 维护
公开更新于 2026年7月21日,内容持续校对官方文档。