快速入门：在 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：克隆.

2. 输入仓库网址（例如，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：初始化仓库.

步骤2：进行修改并审核

Git 会追踪项目中文件的变更。VS Code 中的源代码控制视图是你管理这些更改的枢纽，无需使用命令行。

我们做一个简单的代码修改，然后用源代码控制视图和差异编辑器来审查。

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

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

2. 打开源控制器视图（⌃⇧G（Windows，Linux Ctrl+Shift+G））。

   注意更改的文件在更改中列出，旁边有“U”（未追踪）或“M”（修改）图标。活动栏中的源代码控制图标还会显示一个带有受影响文件数量的徽章。

   

3. 要查看文件的更改，请在源代码控制视图中选择该文件，打开差异编辑器。

   diff编辑器显示当前版本文件与上次提交版本之间的差异。如果窗口足够宽，差别编辑器会显示并排对比，否则更改会内联显示。

   

   提示

   如果你有 Copilot 订阅，请在源控视图中选择代码审查按钮，在提交更改前对 AI 驱动的代码审查。

   

第三步：准备并承诺

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问题。
• 源代码控制概述——完整参考资料。