快速入门：在 VS Code 中使用源代码管理

在 Visual Studio Code 中几分钟内即可上手并运行 Git。本指南涵盖了设置仓库、保存更改以及同步代码的基本知识。

前提条件

1. 安装 Git：确保计算机上已安装 Git。下载 Git

2. 打开 VS Code：确保已安装最新版本的 Visual Studio Code。

第 1 步：打开项目

你可以从现有的 Git 仓库或本地项目文件夹开始。

选项 A：在本地克隆仓库

如果你想处理已托管在 GitHub、Azure DevOps 或其他 Git 提供商上的代码，请克隆仓库。如果你以前克隆过该仓库，可以直接在 VS Code 中打开该文件夹，VS Code 将自动检测到 Git 仓库。

要在 VS Code 中克隆仓库

1. 打开源代码管理视图（⌃⇧G (Windows, Linux Ctrl+Shift+G)）并选择克隆仓库

   

   或者，打开命令面板（⇧⌘P (Windows, Linux Ctrl+Shift+P)）并输入 Git: Clone。

2. 输入仓库 URL（例如 https://github.com/microsoft/PowerToys）

   如果你是从 GitHub 克隆，也可以选择从 GitHub 克隆并登录你的 GitHub 帐户以查看你的仓库列表。

3. 在计算机上选择一个父文件夹来保存项目

4. 出现提示时选择打开，以便在 VS Code 中打开克隆的仓库

5. 在工作区信任对话框中确认你是否信任该仓库

   注意

   仅信任来自已知来源的仓库。不受信任的代码可能会损害你的计算机。

选项 B：在本地文件夹中初始化仓库

要使用 Git 启动新项目，你可以在现有的本地文件夹中初始化仓库。此选项将在你的文件夹中创建一个新的 Git 仓库来跟踪更改。

1. 在 VS Code 中打开你的项目文件夹（文件 > 打开文件夹...）。

2. 打开源代码管理视图（⌃⇧G (Windows, Linux Ctrl+Shift+G)）并选择初始化仓库

   

   或者，打开命令面板（⇧⌘P (Windows, Linux Ctrl+Shift+P)）并输入 Git: Initialize Repository。

第 2 步：修改并查看更改

Git 会跟踪项目中文件的更改。VS Code 中的源代码管理视图是你无需使用命令行即可管理这些更改的中心。

让我们做一个简单的代码更改，并使用源代码管理视图和差异编辑器进行查看。

1. 编辑项目中的现有文件并保存。

   如果你刚刚初始化了一个新仓库，可以进入下一步。

2. 打开源代码管理视图（⌃⇧G (Windows, Linux Ctrl+Shift+G)）。

   请注意，更改的文件会列在更改下方，旁边带有“U”（未跟踪）或“M”（已修改）图标。活动栏中的源代码管理图标也会显示一个带有受影响文件数量的徽标。

   

3. 要查看对文件的更改，请在源代码管理视图中选择它以打开差异编辑器。

   差异编辑器显示文件的当前版本与最后提交的版本之间的差异。如果窗口足够宽，差异编辑器将并排显示比较结果，否则将以内联方式显示更改。

   

   提示

   如果你拥有 Copilot 订阅，请选择源代码管理视图中的“代码审查”按钮，以便在提交更改之前对更改进行 AI 驱动的代码审查。

   

第 3 步：暂存并提交

Git 使用两步流程来保存更改：暂存（准备）和提交（保存）。在源代码管理视图中，更改首先列在更改下，暂存后，它们会移至暂存的更改，准备进行提交。

1. 要暂存更改，请执行以下操作之一

   • 将鼠标悬停在更改列表中的文件上，然后选择 +（加号）将其暂存

     

   • 右键单击更改列表中的文件，然后选择暂存更改

   • 将鼠标悬停在更改标题上，然后选择 +（加号）按钮以一次性暂存所有更改

2. （可选）如果需要，你可以取消暂存更改或丢弃更改

   • 要取消暂存文件，请将鼠标悬停在暂存的更改列表中的该文件上，然后选择 -（减号）按钮

   • 要丢弃对文件的更改，请右键单击更改列表中的该文件，然后选择丢弃更改

3. 要提交暂存的更改，你可以提供一条提交信息。

   1. 在源代码管理视图顶部的文本框中输入提交信息。

      你还可以通过选择提交信息输入框中的闪烁图标 ，使用 AI 根据暂存的更改生成提交信息。

   2. 选择提交以将更改提交到你的 Git 历史记录中

      

      提交后，暂存的更改将从源代码管理视图中清除，并保存在你的本地 Git 历史记录中。

      注意

      只有暂存的更改才会包含在提交中。如果你有未暂存的更改，它们将继续列在更改下以供将来提交。

4. 要查看提交历史记录，请在源代码管理视图中选择源代码管理图。

   

第 4 步：与服务器同步

如果你的仓库连接到了远程服务器（例如 GitHub 或 Azure DevOps），你可以将本地提交与远程仓库同步。

1. 打开源代码管理视图（⌃⇧G (Windows, Linux Ctrl+Shift+G)）

2. 选择同步更改以从远程拉取最新更改并推送你的本地提交

   

   或者，状态栏会显示同步状态，并允许你通过选择同步图标（旋转的箭头）来同步更改。

3. 选择它以从服务器拉取新更改并推送你的提交。

4. 要单独拉取或推送，请选择源代码管理视图中的省略号菜单 (...) 并选择拉取或推送。

   

下一步计划

既然你已经了解了基础知识，接下来可以探索更多功能

• 分支和工作树 - 了解分支管理和并行开发。
• 仓库和远程 - 了解克隆、发布以及与远程仓库同步。
• 解决合并冲突 - 了解如何在合并分支时处理冲突。
• 使用 GitHub - 了解拉取请求和问题。
• 故障排除 - 诊断并解决 Git 问题。
• 源代码管理概述 - 源代码管理功能的完整参考。