在 Visual Studio Code (VS Code) 中使用 Git

一、前置要求

1. 安装 Git：

   • Git 官方下载地址。
   • 安装完成后，确保命令行能正常使用 git 命令：

     git --version
     

2. 配置 Git：

   • 设置用户名和邮箱：

     git config --global user.name "Your Name"
     git config --global user.email "your_email@example.com"
     

3. 安装 VS Code：

   • VS Code 官方下载地址。

4. 检查 Git 插件：

   • VS Code 内置 Git 支持，无需额外安装。如果未启用：
     • 打开 VS Code，进入扩展市场，搜索并启用 Git 插件,推荐Git Graph。

---

二、在 VS Code 中使用 Git 的操作流程

1. 初始化仓库

1.1 新建本地 Git 仓库

• 打开 VS Code 的工作目录。
• 使用内置 Git 进行初始化：
  • 图形界面操作：
    1. 点击左侧 Source Control 图标。
    2. 点击 Initialize Repository 按钮。
  • 命令行操作：
    打开终端，运行：

    git init
    

1.2 克隆远程仓库

• 图形界面操作：
  1. 点击左侧 Source Control 图标。
  2. 点击三点菜单 (···)，选择 Clone Repository。
  3. 输入远程仓库 URL。
• 命令行操作：
  打开终端，运行：

  git clone <repository_url>
  

---

2. 查看修改状态

• 图形界面操作：
  • 在 Source Control 面板，查看当前工作区文件的状态：
    • M 表示已修改文件。
    • A 表示新添加文件。
    • D 表示删除文件。
• 命令行操作：

  git status
  

---

3. 提交更改

3.1 添加文件到暂存区

• 图形界面操作：
  • 在 Source Control 面板中，点击文件旁的 + 图标。
• 命令行操作：

  git add <file_name>        # 添加单个文件
  git add .                  # 添加所有更改
  

3.2 提交到本地仓库

• 图形界面操作：
  • 在 Source Control 面板顶部输入提交信息，点击对勾（✔）提交。
• 命令行操作：

  git commit -m "Your commit message"
  

---

4. 同步远程仓库

4.1 设置远程仓库地址

• 命令行操作：

  git remote add origin <repository_url>
  

4.2 推送到远程仓库

• 图形界面操作：
  • 点击三点菜单 (···)，选择 Push。
• 命令行操作：

  git push -u origin <branch_name>
  

4.3 拉取远程更新

• 图形界面操作：
  • 点击三点菜单 (···)，选择 Pull。
• 命令行操作：

  git pull origin <branch_name>
  

---

5. 分支管理

5.1 创建分支

• 图形界面操作：
  • 点击底部状态栏的分支名称，选择 Create New Branch。
• 命令行操作：

  git branch <new_branch_name>
  

5.2 切换分支

• 图形界面操作：
  • 点击底部状态栏的分支名称，选择目标分支。
• 命令行操作：

  git checkout <branch_name>
  

5.3 删除分支

• 图形界面操作：
  • 点击三点菜单 (···)，选择 Delete Branch。
• 命令行操作：

  git branch -d <branch_name>
  

---

6. 合并分支

• 图形界面操作：
  1. 切换到目标分支。
  2. 点击三点菜单 (···)，选择 Merge Branch，然后选择要合并的分支。
• 命令行操作：

  git checkout <target_branch>
  git merge <source_branch>
  

---

7. 解决冲突

• 冲突检测：
  • 在合并或拉取操作后，冲突文件会显示在 Source Control 面板。
• 解决方法：
  1. 点击冲突文件，使用内置的冲突解决工具（选择保留的版本）。
  2. 解决后重新暂存文件并提交。

---

8. 查看日志和历史

• 图形界面操作：
  • 安装扩展插件如 GitLens，以可视化方式查看历史记录。
• 命令行操作：

  git log
  

---

9. 标签管理

• 创建标签：

  git tag <tag_name>
  

• 推送标签：

  git push origin <tag_name>
  

• 删除标签：

  git tag -d <tag_name>
  git push origin :refs/tags/<tag_name>
  

---

三、提升体验的推荐插件

1. GitLens

• 功能：
  • 查看提交历史。
  • 可视化文件变化。
• 安装：
  • 打开扩展市场，搜索 GitLens 并安装。

2. Git Graph

• 功能：
  • 图形化分支管理。
  • 快速操作分支。
• 安装：
  • 打开扩展市场，搜索 Git Graph 并安装。

---

四、常见问题与解决方案

1. 无法推送到远程仓库

• 检查是否已设置远程地址：

  git remote -v
  

• 添加远程地址：

  git remote add origin <repository_url>
  

2. 合并冲突

• 冲突文件处理后，重新执行：

  git add <file_name>
  git commit
  

3. 无法拉取远程更新

• 确保当前分支已跟踪远程分支：

  git branch --set-upstream-to=origin/<branch_name> <branch_name>
  

---

五、参考资料

1. VS Code 官方文档 - Git 集成
2. Git 官方文档
3. MDN Web Docs - Git 基础教程

​