快速入门：在 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 问题。
• 源代码管理概述 - 源代码管理功能的完整参考。