VSCode 开箱即用支持 Git,核心是熟悉 Git 面板、命令面板快捷键(如 Ctrl+Shift+G/Ctrl+Shift+P)、多根工作区与子模块管理,并推荐启用智能提交和 Conventional Commits 规范。

VSCode 对 Git 的支持非常成熟,开箱即用,不需要额外插件就能完成日常开发中的绝大部分版本控制操作。关键在于熟悉界面逻辑、掌握快捷方式,并理解 VSCode 如何将 Git 命令“翻译”成可视化操作。
Git 面板:你的版本控制中枢
左侧活动栏点击 Git 图标(或按 Ctrl+Shift+G),就打开 Git 面板。这里集中显示所有待提交的更改(Staged / Unstaged)、已暂存文件、提交历史和分支信息。
- 未暂存的修改会列在 “CHANGES” 下,右键可单独暂存(Stage)、丢弃(Discard)或比较(Compare with HEAD)
- 暂存后移入 “STAGED CHANGES”,可直接输入提交信息并点击对勾图标提交
- 点击文件名可唤出内联差异视图,绿色是新增,红色是删除,点行号前的 + 或 - 可选择性暂存/撤销某几行
命令面板与快捷键:比鼠标更快的操作流
按 Ctrl+Shift+P 打开命令面板,输入关键词能快速执行 Git 操作,比如:
- Git: Pull —— 拉取远程更新(等效 git pull)
- Git: Push —— 推送本地提交(等效 git push)
- Git: Create Branch —— 新建分支并自动切换
- Git: Checkout to… —— 切换已有分支或提交
- 配合 Ctrl+K Ctrl+G 快速跳转到当前文件的改动位置
多根工作区与子模块:复杂项目也能理清
VSCode 支持多文件夹工作区(.code-workspace),每个文件夹可独立拥有 Git 仓库。状态栏左下角会显示当前焦点文件夹对应的分支名和变更数。
- 子模块(submodule)会被识别为嵌套 Git 仓库,Git 面板中以不同颜色标识,右键菜单提供 “Open in Integrated Terminal” 方便进入子模块目录执行原生命令
- 提交时默认只提交主仓库的变更;若要提交子模块更新,需先在子模块目录内完成提交,再在主仓库中暂存并提交其 .gitmodules 和子模块指针
提交模板与常规提交规范
通过设置 git.enableSmartCommit 为 true,可开启“智能提交”——当暂存区为空但有未暂存修改时,自动暂存所有更改后提交。更推荐的做法是配合提交模板养成好习惯:
- 在项目根目录创建 .vscode/settings.json,加入:
"git.inputBoxHistory": true,"git.postCommitCommand": "push" - 启用 Conventional Commits 插件(如 “Git Commit Template”),自动生成符合 feat/fix/docs 格式的提交前缀
- 提交信息第一行保持在 50 字以内,空一行后写详细说明,便于生成清晰的 CHANGELOG
基本上就这些。VSCode 的 Git 集成不复杂但容易忽略细节,真正用顺手之后,很多操作比终端还快。










