VS Code 集成 Git 开发工作流实战指南

在现代软件开发中，版本控制是团队协作的基石。VS Code 内置的 Git 可视化工具让代码管理变得直观高效。本文将梳理从环境配置到日常协作的全流程，结合图形界面与命令行操作，帮助你优雅地管理代码。

1. 环境准备与基础配置

首先确保安装了最新版 VS Code 和 Git。安装 Git 时默认选项通常即可满足需求，完成后在终端输入 git --version 验证安装状态。

接下来需要告知 Git 你的身份信息，这会影响提交记录的署名：

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

2. 配置远程仓库免密连接

为了推送代码时不频繁输入密码，建议配置 SSH 密钥。

生成密钥

在终端执行以下命令（替换为你自己的邮箱）：

ssh-keygen -t ed25519 -C "[email protected]"

按回车确认默认路径和密码设置即可。

添加公钥到 GitHub

生成的公钥位于 ~/.ssh/id_ed25519.pub。你可以直接复制文件内容，或者使用系统剪贴板命令快速复制：

Windows: clip < ~/.ssh/id_ed25519.pub
Mac/Linux: pbcopy < ~/.ssh/id_ed25519.pub

3. 项目初始化与克隆

根据场景不同，有两种常见方式：

新建本地项目：打开文件夹后，点击左侧源代码管理图标，选择 Initialize Repository。

克隆已有项目：使用 Git: Clone 命令，粘贴仓库链接。新手建议使用 HTTPS 链接，首次推送时通过浏览器授权即可实现免密；进阶用户若已配置 SSH，可使用 [email protected] 开头的链接。

4. 忽略文件配置

依赖包、编译产物等无需上传的文件应加入 .gitignore。在项目根目录创建该文件，填入如下内容：

node_modules/
dist/
.vscode/
.DS_Store

配置后，这些文件将不再出现在版本变动提示中，保持仓库纯净。

5. 核心工作流：暂存与提交

VS Code 清晰展示了代码状态流转：工作区 -> 暂存区 -> 本地仓库。

界面操作：修改代码后，左侧面板会显示变动文件。点击右侧 + 号将文件加入暂存区，然后在顶部输入框填写提交说明（如 feat: login page layout），点击 Commit 完成。

命令行对应：

# 查看状态
git status
# 暂存所有修改
git add .
# 提交并备注
git commit -m "feat: login page layout"

VS Code 集成 Git 开发工作流实战指南