Azure Repos 中的 Git 入门

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

开始使用 Azure Repos 和 Git 存储库开发代码。 可以使用 Visual Studio 或 Git 命令克隆存储库、定义本地分支、提交和推送更改，以及与其他人同步。 如果需要创建或导入存储库，请参阅在项目中创建新的 Git 存储库或导入 Git 存储库。

注意

本文介绍如何使用 Visual Studio 管理 Azure Repos Git 存储库。 使用类似的过程，可以使用 Visual Studio 来管理 GitHub 存储库。 要克隆 GitHub 存储库，请获取 URL，如克隆存储库中所述。

有关 Git 工作流的概述，请参阅 Azure Repos Git 教程。

注意

Visual Studio 2019 版本 16.8 及更高版本提供了用于管理 Git 工作流的新 Git 菜单，其上下文切换比团队资源管理器少。 本文在 Visual Studio 选项卡下提供的过程提供了有关使用 Git 体验以及团队资源管理器的信息。 要了解详细信息，请参阅并排比较 Git 和团队资源管理器。

先决条件

• 必须在 Azure DevOps 项目设置中启用 Repos。 如果 Repos 中心和关联页面未显示，请参阅打开或关闭 Azure DevOps 服务以重新启用 Repos。

• 若要查看专用项目中的代码，必须是 Azure DevOps 项目的成员，具有基本访问级别或更高级别。 对于公共项目，每个人都可以查看代码。

  • 如果没有项目，请创建一个或免费注册。

  • 如果你不是项目成员，请添加为成员。

• 若要克隆或贡献专用项目的代码，必须是“参与者”安全组的成员或具有相应的权限集。 对于公共项目，任何人都可以克隆和贡献代码。 若要了解详细信息，请参阅什么是公共项目？

  注意

  对于公共项目，被授予利益干系人访问权限的用户对 Azure Repos 具有完全访问权限。

若要了解有关权限和访问权限的详细信息，请参阅默认 Git 存储库和分支权限及关于访问级别。

获取代码

可以克隆远程 Git 存储库以创建其本地副本。 克隆会创建供你使用的源代码副本和版本控制信息，以便 Git 可以管理源代码。

如果想要在不克隆的情况下创建本地存储库，请参阅创建新的 Git 存储库。 创建本地存储库后，可以继续提交、共享和同步工作。

Visual Studio 2022

Visual Studio 2022 通过使用“Git”菜单、“Git 更改”和“解决方案资源管理器”中的上下文菜单提供 Git 版本控制体验。 Visual Studio 2019 版本 16.8 还提供了团队资源管理器 Git 用户界面。 有关详细信息，请参阅“Visual Studio 2019 - 团队资源管理器”选项卡。

1. 在菜单栏上的“Git”菜单中，选择“克隆存储库...”

   

2. 在“克隆存储库”窗口中，输入克隆的存储库的远程存储库位置和文件夹路径。 如果不知道远程存储库位置，请从“浏览存储库”选项中选择“Azure DevOps”。

   

3. 选择“克隆”。 克隆 Git 存储库之后，Visual Studio 将检测该存储库，并将其添加到 Git 菜单中的“本地存储库”列表。

   

注意

使用 Azure DevOps Services 时，项目 URL 的格式为 dev.azure.com/{your organization}/{your project}。 但是，仍然支持以前引用 visualstudio.com 格式的格式。 有关详细信息，请参阅 Azure DevOps 简介 - 将现有组织切换为使用新的域名 URL。

Visual Studio 2019 - Git 菜单

Visual Studio 2019 通过使用“Git”菜单、“Git 更改”和“解决方案资源管理器”中的上下文菜单提供 Git 版本控制体验。

1. 在菜单栏上的“Git”菜单中，选择“克隆存储库...”

   

2. 在“克隆存储库”窗口中，输入克隆的存储库的远程存储库位置和文件夹路径。 如果不知道远程存储库位置，请从“浏览存储库”选项中选择“Azure DevOps”。

   

3. 选择“克隆”。 克隆 Git 存储库之后，Visual Studio 将检测该存储库，并将其添加到 Git 菜单中的“本地存储库”列表。

   

注意

使用 Azure DevOps Services 时，项目 URL 的格式为 dev.azure.com/{your organization}/{your project}。 但是，仍然支持以前引用 visualstudio.com 格式的格式。 有关详细信息，请参阅 Azure DevOps 简介 - 将现有组织切换为使用新的域名 URL。

Visual Studio 2019 - 团队资源管理器

Visual Studio 2019 版本 16.8 及更高版本提供 Git 版本控制体验，同时保留团队资源管理器 Git 用户界面。 可以互换使用任一界面中的 Git 功能。

注意

通过团队资源管理器连接到项目的一个优点是可以访问工作项中心。 有关团队资源管理器功能的概述，请参阅在 Visual Studio 团队资源管理器中导航。

1. 在团队资源管理器中，选择“连接”以打开“连接”页面，然后选择“管理连接”>“连接到项目”。

   

2. 在“连接到项目”窗口中，选择要克隆的存储库，然后选择“克隆”。 如果没有看到存储库，请选择“添加 Azure DevOps Server”以添加托管存储库的服务器。 可以筛选列表以查找存储库。

   

3. 验证克隆的存储库在计算机上的位置，然后选择“克隆”。

注意

使用 Azure DevOps Services 时，项目 URL 的格式为 dev.azure.com/{your organization}/{your project}。 但是，仍然支持以前引用 visualstudio.com 格式的格式。 有关详细信息，请参阅 Azure DevOps 简介 - 将现有组织切换为使用新的域名 URL。

Git 命令行

1. 下载并安装 Git 以及适用于平台的 Git 凭据管理器。

2. 转到 https://<your account name>.visualstudio.com，在浏览器中打开 Azure DevOps Services Web 门户。

3. 导航到 https://<your account name>.visualstudio.com，在浏览器中打开 Azure DevOps Services Web 门户，并查找 Git 存储库。 从“克隆”弹出窗口复制克隆 URL。

   

   注意

   使用 Azure DevOps Services 时，项目 URL 的格式为 dev.azure.com/{your organization}/{your project}。 但是，仍然支持以前引用 visualstudio.com 格式的格式。 有关详细信息，请参阅 Azure DevOps 简介 - 将现有组织切换为使用新的域名 URL。

4. 在命令提示符下，转到要将代码存储在本地计算机上的文件夹。

5. 在命令提示符下，运行 git clone，后跟克隆 URL，如以下示例所示。

    > git clone https://dev.azure.com/fabrikam-fiber/_git/FabrikamFiber
   

   Git 会为你下载代码并在新文件夹中创建代码的副本。

提交工作

Git 分支会将你的更改与项目中的其他工作分离开来。 建议的 Git 工作流是为你处理的每项功能或修复使用新分支。 可以在本地 Git 存储库中进行提交，以将更改保存到该分支上。

Visual Studio 2022

1. 从菜单栏上的“Git”菜单中选择“新建分支...”，以打开“创建新分支”窗口。

   

2. 在“创建新分支”窗口中，输入描述性分支名称，让其他人知道该分支包含的工作。 默认情况下，Visual Studio 从当前分支创建新分支。 “签出分支”复选框会自动切换到新创建的分支。 选择“创建” 。

   

3. 将 README.md 文件添加到克隆的存储库。 在解决方案资源管理器中，可以使用“文件夹视图”浏览存储库内容，或在存储库中打开 Visual Studio 解决方案。 Git 会跟踪在 Visual Studio 内部和外部所做的更改。

4. 如果对更改感到满意，请使用提交将其保存在 Git 中。 在“Git 更改”窗口中，输入描述更改的消息，然后选择“全部提交”。 “全部提交”会提交非暂存更改并跳过暂存区域。 可以通过选择“Git 更改”窗口中“更改”部分顶部的全部暂存 +（加号）按钮，选择在提交前暂存所有文件。

   

   选择提交信息链接以获取有关提交的更多详细信息。

   

备注

如果有多个文件，但不想提交全部文件，可以右键单击每个文件并选择“暂存”。 暂存要提交的所有文件后，选择“提交已暂存文件”。 手动暂存更改时，“提交已暂存文件”将替换“全部提交”。

Visual Studio 2019 - Git 菜单

1. 从菜单栏上的“Git”菜单中选择“新建分支...”，以打开“创建新分支”窗口。

   

2. 在“创建新分支”窗口中，输入描述性分支名称，让其他人知道该分支包含的工作。 默认情况下，Visual Studio 从当前分支创建新分支。 “签出分支”复选框会自动切换到新创建的分支。 选择“创建” 。

   

3. 将 README.md 文件添加到克隆的存储库。 在解决方案资源管理器中，可以使用“文件夹视图”浏览存储库内容，或在存储库中打开 Visual Studio 解决方案。 Git 会跟踪在 Visual Studio 内部和外部所做的更改。

4. 如果对更改感到满意，请使用提交将其保存在 Git 中。 在“Git 更改”窗口中，输入描述更改的消息，然后选择“全部提交”。 “全部提交”会提交非暂存更改并跳过暂存区域。 可以通过选择“Git 更改”窗口中“更改”部分顶部的全部暂存 +（加号）按钮，选择在提交前暂存所有文件。

   

   选择提交信息链接以获取有关提交的更多详细信息。

   

备注

如果有多个文件，但不想提交全部文件，可以右键单击每个文件并选择“暂存”。 暂存要提交的所有文件后，选择“提交已暂存文件”。 手动暂存更改时，“提交已暂存文件”将替换“全部提交”。

Visual Studio 2019 - 团队资源管理器

1. 在团队资源管理器中，选择“主页”按钮并选择“分支”。

   

2. 右键单击通常名为 main 的默认分支，然后选择“新建本地分支源...”

   

3. 输入描述性分支名称，让其他人知道该分支包含的工作。 选择“创建分支”。

   

4. 将 README.md 文件添加到克隆的存储库。 在团队资源管理器的“主页”视图中，可以使用“显示文件夹视图”浏览存储库内容，或在存储库中打开 Visual Studio 解决方案。 Git 会跟踪在 Visual Studio 内部和外部所做的更改。

5. 如果对更改感到满意，请使用提交将其保存在 Git 中。 通过依次选择“主页”按钮和“更改”，打开团队资源管理器的“更改”视图。

   

6. 输入描述提交的消息，然后选择“全部提交”。

   

注意

如果有多个文件，但不想提交全部文件，可以右键单击每个文件并选择“暂存”。 暂存要提交的所有文件后，选择“提交已暂存文件”。 手动暂存更改时，“提交已暂存文件”将替换“全部提交”。

Git 命令行

1. 创建一个可在其中对代码进行更改的分支。 如果使用某人创建的分支与此人协作，则可以跳到下面的 git checkout 步骤。

    > git branch ReadMeFix
   

   为工作选择一个描述性分支名称，以提醒你和其他人分支中的工作类型。

2. 签出分支，以便可以开始在其中工作。

    > git checkout ReadMeFix
   

   还可以使用 checkout 命令开始处理其他团队成员已在其中工作的分支。

3. 使用你喜欢的工具对代码进行更改。

4. 如果对更改感到满意，即使尚未准备好共享工作，也可以使用提交将更改保存在 Git 中。 在推送更改之前，不会共享更改，如以下部分所述。

    > git commit -a -m "Descriptive message"
   

   此命令将更改本地保存到 Git 中的新提交。 确保在 -m 后面为提交提供一条描述更改的短消息。

共享所做的更改

在向分支添加一个或多个提交并准备好与其他人共享这些更改后，推送提交，以便其他人可以看到它们。

推送提交后，可以创建拉取请求。 拉取请求可让其他人知道你希望你的更改得到审阅。 批准后，拉取请求通常会将更改添加到远程存储库的默认分支。

Visual Studio 2022

1. 在“Git 更改”窗口中，选择向上箭头按钮以推送提交。

   

   你也可以从“Git 存储库”窗口推送所做的更改。 要打开“Git 存储库”窗口，请在“Git 更改”窗口中选择传出/传入链接。

   

   你也可以从菜单栏上的“Git”菜单推送所做的更改。

   

2. 创建拉取请求，以便其他人可以查看你的更改。 如果刚刚从“Git 更改”窗口推送了更改，则可以选择“创建拉取请求”链接以打开 Web 浏览器，可在该浏览器中在 Azure Repos Web 门户中创建新的拉取请求。

   

   或者，如果刚刚从“Git 存储库”窗口推送了更改，则可以选择该窗口顶部的“创建拉取请求”链接。

   

   或者，可以右键单击“Git 存储库”窗口中的任意分支，然后选择“创建拉取请求”。

   

当拉取请求在 Azure Repos Web 门户中打开时，请验证源分支和目标分支。 在此示例中，我们希望将 add-readme-file 分支中的提交合并到 main 分支中。 输入标题和可选说明，指定任何审阅者，可以选择关联任何工作项，然后选择“创建”。

有关拉取请求的详细信息，请参阅拉取请求教程。

Visual Studio 2019 - Git 菜单

1. 在“Git 更改”窗口中，选择向上箭头按钮以推送提交。

   

   你也可以从“Git 存储库”窗口推送所做的更改。 要打开“Git 存储库”窗口，请在“Git 更改”窗口中选择传出/传入链接。

   

   你也可以从菜单栏上的“Git”菜单推送所做的更改。

   

2. 创建拉取请求，以便其他人可以查看你的更改。 如果刚刚从“Git 更改”窗口推送了更改，则可以选择“创建拉取请求”链接以打开 Web 浏览器，可在该浏览器中在 Azure Repos Web 门户中创建新的拉取请求。

   

   或者，如果刚刚从“Git 存储库”窗口推送了更改，则可以选择该窗口顶部的“创建拉取请求”链接。

   

   或者，可以右键单击“Git 存储库”窗口中的任意分支，然后选择“创建拉取请求”。

   

当拉取请求在 Azure Repos Web 门户中打开时，请验证源分支和目标分支。 在此示例中，我们希望将 add-readme-file 分支中的提交合并到 main 分支中。 输入标题和可选说明，指定任何审阅者，可以选择关联任何工作项，然后选择“创建”。

有关拉取请求的详细信息，请参阅拉取请求教程。

Visual Studio 2019 - 团队资源管理器

1. 在“团队资源管理器”中，选择“主页”，然后选择“同步”以打开“同步”。

   

   你还可以在进行提交后立即选择“同步”，从“更改”转到“同步”视图。

   

2. 在“同步”视图中，选择“推送”将提交上传到远程存储库。 如果这是你第一次推送到存储库，你将看到消息 The current branch does not track a remote branch...，该消息告知你已将提交推送到远程存储库上的新分支，并且从当前分支推送的未来提交将上传到该远程分支。

   

3. 创建拉取请求，以便其他人可以查看你的更改。 通过选择“主页”并选择“拉取请求”，在“团队资源管理器”中打开“拉取请求”。

   

4. 在“拉取请求”中，可以查看由你打开的拉取请求、分配给你的拉取请求，并且可以创建新的拉取请求。 选择“新建拉取请求”以打开 Web 浏览器，可在该浏览器中在 Azure Repos Web 门户中创建新的拉取请求。

   

当拉取请求在 Azure Repos Web 门户中打开时，请验证源分支和目标分支。 在此示例中，我们希望将 add-readme-file 分支中的提交合并到 main 分支中。 输入标题和可选说明，指定任何审阅者，可以选择关联任何工作项，然后选择“创建”。

有关拉取请求的详细信息，请参阅拉取请求教程。

Git 命令行

1. 推送分支，以便其他人可以看到你保存的更改。

    > git push -u origin ReadMeFix
   

2. 在 Web 门户中打开项目，并浏览到“代码”选项卡下的存储库。选择“创建拉取请求”为推送的分支创建拉取请求。

   

3. 验证分支。 在此示例中，我们希望将 ReadMeFix 分支中的提交合并到 main 分支中。 输入标题和可选说明，指定任何审阅者，可以选择关联任何工作项，然后选择“创建”。

   

4. 更改获得批准后，完成拉取请求。 完整的拉取请求会将分支中的更改添加到代码的 main 分支中。

   有关拉取请求的详细信息，请参阅拉取请求教程。

与其他人同步

可以通过拉取其他人创建的提交，使本地分支与其远程分支保持同步。 虽然 Git 擅长将传入更改与你的更改合并，但有时你可能需要解决合并冲突。 在处理功能分支时，最好定期切换到 main 分支并拉取新提交，使其与远程 main 分支保持同步。

Visual Studio 2022

在“Git 更改”窗口中，可以使用“提取”、“拉取”、“推送”和“同步”按钮使本地分支与其远程分支保持同步。

在上一个屏幕截图中，按钮控件从左到右依次为：

• “提取”下载不在本地分支中的远程提交，但不会合并它们。
• “拉取”执行提取，然后将下载的提交合并到本地分支中。
• “推送”将未推送的提交上传到远程存储库，该存储库会将其添加到相应的远程分支。
• “同步”依次执行“拉取”和“推送”操作。

也可以从 Git 菜单中选择“提取”、“拉取”、“推送”和“同步”。

Visual Studio 2019 - Git 菜单

在“Git 更改”窗口中，可以使用“提取”、“拉取”、“推送”和“同步”按钮使本地分支与其远程分支保持同步。

在上一个屏幕截图中，按钮控件从左到右依次为：

• “提取”下载不在本地分支中的远程提交，但不会合并它们。
• “拉取”执行提取，然后将下载的提交合并到本地分支中。
• “推送”将未推送的提交上传到远程存储库，该存储库会将其添加到相应的远程分支。
• “同步”依次执行“拉取”和“推送”操作。

也可以从 Git 菜单中选择“提取”、“拉取”、“推送”和“同步”。

Visual Studio 2019 - 团队资源管理器

1. 在“团队资源管理器”中，选择“主页”，然后选择“同步”以打开“同步”。

   

2. 可以使用“拉取”链接将最新更改下载到分支。 有两个“拉取”链接，一个靠近顶部，另一个在“传入提交”部分中。 可以使用其中的任何一个链接，因为它们均执行相同的操作。

   

Git 命令行

1. 切换到要在其中下载其他人所做的更改的分支。

    > git checkout ReadMeFix
   

   在此示例中，你将团队中其他人对 ReadMeFix 分支所做的更改拉取到该分支的本地副本。

2. 将其他人所做的更改拉取到本地分支。

    > git pull
   

   Git 将下载更改并将其与你自己的更改合并到本地分支中。

相关文章

• Git 常见问题解答
• Visual Studio 中的 Git 体验
• Git 和团队资源管理器的并行比较