VS Code 集成 Git 安装与配置实战指南
在开发流程中,版本控制是不可或缺的一环。VS Code 本身不内置 Git 功能,需要配合系统级的 Git 工具使用。下面梳理一套从环境搭建到日常协作的完整方案,Windows 和 macOS 通用。
一、安装 Git 客户端
VS Code 依赖外部 Git 命令,所以第一步是在操作系统上安装 Git。
Windows 用户
访问官网 https://git-scm.com/downloads 下载 Windows 安装包。安装过程中保持默认选项即可,后续配置会自动处理路径问题。
macOS 用户
推荐使用 Homebrew 安装,比手动下载更便捷:
brew install git
验证安装
打开终端(VS Code 内按 Ctrl + `` 或 Cmd + ``),输入以下命令检查版本:
git --version
看到版本号输出即表示安装成功。
二、全局身份配置
Git 提交时需要记录作者信息,这通常只需要配置一次。在终端执行以下命令替换为你自己的信息:
git config --global user.name "你的名字"
git config --global user.email "你的邮箱@xxx.com"
配置完成后,可以通过 git config --list 查看当前设置是否生效。
三、增强插件推荐
虽然原生功能已够用,但安装几个插件能显著提升体验:
- GitLens:支持行级历史追踪,点击代码右侧图标即可查看谁在何时修改了该行,方便回溯。
- Git Graph:以可视化图表展示分支结构和提交历史,理清复杂的合并关系一目了然。
安装路径:VS Code 左侧扩展面板搜索名称后点击 Install。
四、核心工作流操作
初始化仓库
进入项目目录,在终端运行:
git init
此时文件夹下会生成 .git 隐藏目录,代表该目录已成为 Git 仓库。
本地提交
VS Code 左侧源代码管理图标(Ctrl+Shift+G)提供了图形化界面:
- 在 Changes 区域选择要提交的文件。
- 在输入框填写提交说明(Commit Message)。
- 点击 Commit 按钮。
这种方式适合日常小步快跑的开发节奏。
关联远程仓库
如果需要将代码同步到 GitHub、Gitee 或 GitLab,需先建立远程连接:
git remote add origin <仓库地址>
推送代码
首次推送时指定上游分支:
git push -u origin main
后续直接 git push 即可。
五、常用快捷键速查
Ctrl+Shift+G:打开源代码管理面板


