快速入门:在 VS Code 中使用源代码管理
在几分钟内使用 Visual Studio Code 中的 Git 入门。本指南涵盖了设置存储库、保存更改和同步代码的基本知识。
先决条件
-
安装 Git:请确保您的计算机上已安装 Git。下载 Git
-
打开 VS Code:请确保您已安装最新版本的Visual Studio Code。
步骤 1:打开项目
您可以从现有的 Git 存储库或本地项目文件夹开始。
选项 A:在本地克隆存储库
如果您想处理已托管在 GitHub、Azure DevOps 或其他 Git 提供商上的代码,请克隆该存储库。如果您之前已克隆该存储库,则可以直接在 VS Code 中打开该文件夹,VS Code 会自动检测到 Git 存储库。
在 VS Code 中克隆存储库
-
打开源代码管理视图(⌃⇧G(Windows、Linux Ctrl+Shift+G)),然后选择“克隆存储库”。

或者,打开命令面板(⇧⌘P(Windows、Linux Ctrl+Shift+P)),然后输入
Git: Clone。 -
输入存储库 URL(例如,
https://github.com/microsoft/PowerToys)。如果您从 GitHub 克隆,还可以选择“从 GitHub 克隆”并登录您的 GitHub 帐户,以查看您存储库的列表。
-
在您的计算机上选择一个父文件夹来保存项目。
-
在提示时选择“打开”以在 VS Code 中打开克隆的存储库。
-
在工作区信任对话框中确认您是否信任该存储库。
注意仅信任您知道来源的存储库。不受信任的代码可能会损害您的计算机。
选项 B:在本地文件夹中初始化存储库
要开始使用 Git 进行新项目,可以在现有本地文件夹中初始化一个存储库。此选项会在您的文件夹中创建一个新的 Git 存储库来跟踪更改。
-
在 VS Code 中打开您的项目文件夹(“文件” > “打开文件夹…”)。
-
打开源代码管理视图(⌃⇧G(Windows、Linux Ctrl+Shift+G)),然后选择“初始化存储库”。

或者,打开命令面板(⇧⌘P(Windows、Linux Ctrl+Shift+P)),然后输入
Git: Initialize Repository。
步骤 2:进行更改并审查
Git 会跟踪您项目中文件的更改。VS Code 中的源代码管理视图是您无需使用命令行即可管理这些更改的中心。
让我们进行一次简单的代码更改,并使用源代码管理视图和 diff 编辑器来审查它。
-
编辑项目中的现有文件,并保存它。
如果您刚刚初始化了一个新存储库,则可以继续执行下一步。
-
打开源代码管理视图(⌃⇧G(Windows、Linux Ctrl+Shift+G))。
请注意,已更改的文件会列在“更改”下,旁边带有“U”(未跟踪)或“M”(已修改)图标。活动栏中的源代码管理图标还会显示一个带有受影响文件数量的徽章。

-
要审查文件的更改,请在源代码管理视图中选择该文件以打开 diff 编辑器。
Diff 编辑器显示当前版本的文件与上次提交的版本之间的差异。如果窗口足够宽,diff 编辑器会显示并排比较;否则,更改会内联显示。
提示如果您有 Copilot 订阅,请选择源代码管理视图中的“代码审查”按钮,以在提交更改之前执行基于 AI 的代码审查。

步骤 3:暂存并提交
Git 使用一个两步过程来保存更改:暂存(准备)和提交(保存)。在源代码管理视图中,更改首先列在“更改”下,暂存它们后,它们会移至“暂存的更改”,准备进行提交。
-
要暂存更改,请执行以下操作之一:
-
将鼠标悬停在“更改”列表中的文件上,然后选择“+”(加号)以暂存它。

-
右键单击“更改”列表中的文件,然后选择“暂存更改”。
-
将鼠标悬停在“更改”标题上,然后选择“+”(加号)按钮以一次暂存所有更改。
-
-
(可选)您可以根据需要取消暂存更改或放弃更改。
-
要取消暂存文件,请将鼠标悬停在“暂存的更改”列表中的该文件上,然后选择“-”(减号)按钮。
-
要放弃文件的更改,请右键单击“更改”列表中的该文件,然后选择“放弃更改”。
-
-
要提交暂存的更改,您可以提供提交消息。
-
在源代码管理视图顶部的文本框中输入提交消息。
您还可以通过选择提交消息输入框中的闪烁图标 ,使用 AI 根据您暂存的更改生成提交消息。
-
选择“提交”以将您的更改提交到 Git 历史记录。

提交后,暂存的更改将从源代码管理视图中清除,并保存在您的本地 Git 历史记录中。
注意只有暂存的更改才会包含在提交中。如果您有未暂存的更改,它们将继续列在“更改”下,以供将来的提交使用。
-
-
要查看您的提交历史记录,请在源代码管理视图中选择“源代码管理图”。

步骤 4:与服务器同步
如果您的存储库已连接到远程服务器(例如 GitHub 或 Azure DevOps),则可以将本地提交与远程存储库同步。
-
打开源代码管理视图(⌃⇧G(Windows、Linux Ctrl+Shift+G))。
-
选择“同步更改”以从远程拉取最新更改并将本地提交推送到远程。

或者,状态栏会显示同步状态,并允许您通过选择同步图标(旋转箭头)来同步更改。
-
选择它以从服务器拉取新更改并将您的提交推送到远程。
-
要单独拉取或推送,请在源代码管理视图中选择省略号菜单(...),然后选择“拉取”或“推送”。

如果您从本地文件夹开始(选项 B)并希望将其保存到 GitHub,请使用源代码管理视图中的“发布到 GitHub”按钮。
后续步骤
既然您已经掌握了基础知识,可以探索更多功能。