安装 Git 基础环境
VS Code 本身不内置 Git,需先安装 Git 软件。
Windows 用户
访问官网 https://git-scm.com/downloads 下载 Windows 版本安装包。安装过程中保持默认配置即可,无需额外调整。
macOS 用户
终端执行以下命令:
brew install git
验证安装
打开 VS Code 终端(快捷键 Ctrl+`),输入:
git --version
若显示版本号,说明安装成功。
配置全局身份信息
在 VS Code 终端中执行以下两条命令,仅需配置一次:
# 设置用户名(GitHub/GitLab 账号)
git config --global user.name "你的名字"
# 设置邮箱(绑定 GitHub/GitLab 的邮箱)
git config --global user.email "你的邮箱@xxx.com"
确认配置是否生效:
git config --list
推荐插件增强体验
VS Code 扩展市场搜索并安装以下两个插件,能显著提升 Git 操作效率:
- GitLens — Git supercharged
- 查看每一行代码的作者及修改时间
- 对比提交历史与分支差异
- Git Graph
- 可视化展示 Git 提交图谱,分支管理一目了然
安装方式:点击左侧扩展图标,搜索名称后点击 Install。
常用操作流程
初始化仓库
进入项目目录,在终端执行:
git init
提交本地代码
- 点击左侧源代码管理图标(Ctrl+Shift+G)
- 在消息框填写本次提交的说明
- 点击提交按钮 + 同步按钮
关联远程仓库
将本地仓库与 GitHub、Gitee 或 GitLab 上的远程地址绑定:
git remote add origin <仓库地址>
推送到远程
首次推送时指定上游分支:
git push -u origin main
常用快捷键
Ctrl+Shift+G:打开 Git 面板Ctrl+Enter:快速提交代码- 点击文件名:查看本次修改内容
- 点击分支名:快速切换分支
常见问题排查
Git 命令无响应
尝试重启 VS Code,确保终端重新加载环境变量。


