VS Code 与 Git 集成开发指南
在 VS Code 中进行版本控制是开发者的日常工作。以下流程涵盖了从 Git 环境搭建到 VS Code 插件配置,再到常用命令操作的完整步骤。
1. 安装 Git
VS Code 依赖系统级的 Git 工具才能运行版本控制功能。
Windows 环境
访问官网 https://git-scm.com/downloads 下载 Windows 安装包。安装过程中保持默认选项即可,无需额外配置。
macOS 环境
推荐使用 Homebrew 安装:
brew install git
验证安装
打开终端(VS Code 内快捷键 Ctrl + `),输入:
git --version
若显示版本号,说明安装成功。
2. 全局配置
首次使用前需设置用户身份,这决定了提交记录的署名信息。只需执行一次:
git config --global user.name "你的名字"
git config --global user.email "你的邮箱@xxx.com"
可通过以下命令检查配置是否生效:
git config --list
3. 推荐插件
为了提升效率,建议安装以下两个扩展:
- GitLens:增强代码历史查看能力,支持行级 blame 和分支对比。
- Git Graph:提供可视化的提交图谱,方便理解分支结构。
在 VS Code 扩展市场搜索名称并点击安装即可。
4. 常用操作流程
初始化仓库
在项目根目录终端执行:
git init
提交代码
- 点击左侧源代码管理图标(Ctrl + Shift + G)。
- 在输入框填写提交说明(Commit Message)。
- 点击'提交'按钮。
关联远程仓库
将本地仓库与 GitHub、Gitee 或 GitLab 上的远程地址绑定:
git remote add origin <你的仓库地址>
推送到远程
首次推送时指定上游分支:
git push -u origin main
*注:部分旧项目可能使用 master 作为主分支名,请根据实际情况调整。
5. 常用快捷键
Ctrl + Shift + G:打开 Git 面板Ctrl + Enter:快速提交当前修改- 点击文件名:查看具体变更内容
- 点击分支名:快速切换分支
6. 常见问题排查
Git 命令不生效
尝试重启 VS Code,确保环境变量已加载。


