快速入门：在 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 中的“源代码管理”视图是您无需使用命令行即可管理这些更改的中心。

让我们进行一次简单的代码更改，并使用“源代码管理”视图和差异编辑器（diff editor）来查看它。

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 - 了解 Pull Request 和 Issue。
• 故障排除 - 诊断并解决 Git 问题。
• 源代码管理概述 - 源代码管理功能的完整参考。