查看、筛选和打开拉取请求

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

Visual Studio 2019 | Visual Studio 2022

创建拉取请求 (PR)，以评审和合并Azure Repos 上的 Git 存储库中的代码更改。 团队成员和利益干系人可以在将代码合并到目标分支之前评审更改并提供反馈。 审阅者还可以对更改进行注释，并投票批准或拒绝代码。

团队可以要求针对受保护分支上任何更改的 PR，并设置分支策略以要求某些 PR 满足特定条件。

可通过多种方式列出、筛选、查看和打开针对项目的 PR。

先决条件

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

• 要查看 PR，必须是 PR 所在的 Azure DevOps 项目的成员，具有基本访问级别或更高级别。 如果你不是项目成员，请添加为成员。

  注意

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

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

• 在 Azure DevOps Services 中，可以使用 azure-devops 扩展从 Azure 命令行接口 (CLI) 管理 PR 和其他资源。 要了解如何使用 Azure DevOps Services CLI，请参阅 Azure DevOps CLI 入门。 用于 PR 的 Azure Repos CLI 命令使用 az repos pr。

列出拉取请求

可以使用 Azure DevOps 项目网站、Visual Studio 或 Azure DevOps 命令行列出 PR。

浏览器

1. 要列出项目中特定存储库中的 PR，请在 Web 门户中转到该项目，然后选择“Repos”>“拉取请求”。

   

2. 验证是否选择了正确的存储库。

   

3. 默认视图在“我的”选项卡下显示你的 PR。选择“活动”可显示当前存储库的所有活动 PR。 选择“已完成”或“已放弃”可显示已关闭的 PR 列表。

   选择列表中的任何 PR 可转到该 PR 的“概述”页。

   

4. 通过在“我的工作”视图中选择“拉取请求”，可以列出组织中不同项目的所有 PR。

   

Visual Studio

要使用 Visual Studio 列出拉取请求，请在“Git”菜单中选择“<你的 Git 服务>”>“查看拉取请求”。

Visual Studio 2019 版本 16.8 及更高版本提供 Git 版本控制体验，同时保留团队资源管理器 Git 用户界面。 若要使用团队资源管理器，请取消选中菜单栏中的“工具”>“选项”>“预览功能”>“新 Git 用户体验”。 可以互换使用任一界面中的 Git 功能。

从 Visual Studio 团队资源管理器访问 PR：

1. 从 Visual Studio 连接到项目。

2. 选择“查看”>“团队资源管理器”，打开团队资源管理器。 还可按 Ctrl+\、Ctrl+M。

3. 从“主页”中选择“拉取请求”，查看由你打开或分配给你的 PR 列表。

4. 要在 Azure DevOps Web 门户中查看 PR 列表，请选择“操作”，然后选择“在浏览器中打开”。

   

Azure DevOps CLI

要列出项目中的活动 PR 及其详细信息，请使用 az repos pr list。

az repos pr list [--creator]
                 [--detect {false, true}]
                 [--include-links]
                 [--org]
                 [--project]
                 [--query-examples]
                 [--repository]
                 [--reviewer]
                 [--skip]
                 [--source-branch]
                 [--status {abandoned, active, all, completed}]
                 [--subscription]
                 [--target-branch]
                 [--top]

参数

参数	说明
--creator	将结果限制为此用户创建的拉取请求。
--detect	自动检测组织。 接受的值：false、true。
--include-links	包括每个拉取请求的链接。
--org --organization	Azure DevOps 组织 URL。 可以使用 az devops configure -d organization=<ORG_URL> 配置默认组织。 如果未配置为默认或未通过 git 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。
--project -p	项目的名称或 ID。 可以使用 az devops configure -d project=<NAME_OR_ID> 配置默认项目。 如果未配置为默认或通过 git 配置进行选取，则为必需。
--query-examples	建议的 JMESPath 字符串。 可以复制其中一个查询，并将其粘贴到 --query 参数后，置于双引号中，以查看结果。 可以添加一个或多个位置关键字，以便根据这些关键字提供建议。
--repository -r	存储库的名称或 ID。
--reviewer	将结果限制为此用户是审阅者的拉取请求。
--skip	要跳过的拉取请求数。
--source-branch -s	将结果限制为源自此源分支的拉取请求。
--status	将结果限制为具有此状态的拉取请求。 接受的值：abandoned、active、all、completed。
--subscription	Azure 订阅的名称或 ID。 可以使用 az account set -s <NAME_OR_ID> 配置默认订阅。
--target-branch -t	将结果限制为面向此分支的拉取请求。
--top	要列出的拉取请求的最大数目。

示例

以下命令列出存储库中的所有 PR（无论状态如何），并在表中显示输出。 该示例使用默认配置 az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"。

az repos pr list --status all --output table

ID    Created     Creator              Title                                           Status     IsDraft    Repository
----  ----------  -------------------  ----------------------------------------------  ---------  ---------  ------------
11    2021-10-04  jamalh@fabrikam.com  Revert 'Updated parameterized-functions.md'     Completed  False      Fabrikam
10    2021-10-04  jamalh@fabrikam.com  Updated parameterized-functions.md              Completed  False      Fabrikam
9     2021-10-04  ke@fabrikam.com      New pull request                                Completed  False      Fabrikam
8     2021-10-04  jamalh@fabrikam.com  Updated parameterized-functions.md              Abandoned  False      Fabrikam
7     2021-09-30  jamalh@fabrikam.com  Added note-new-git-tool.md to /                 Completed  False      Fabrikam
6     2021-09-29  jamalh@fabrikam.com  Revert 'Added parameterized-functions.md to /'  Abandoned  False      Fabrikam
5     2021-09-29  jamalh@fabrikam.com  Updated README.md                               Completed  False      Fabrikam
4     2021-09-29  jamalh@fabrikam.com  Added parameterized-functions.md to /           Completed  False      Fabrikam
3     2021-09-28  jamalh@fabrikam.com  WIP New file                                    Abandoned  False      Fabrikam
2     2021-09-28  jamalh@fabrikam.com  Update README.md                                Abandoned  False      Fabrikam
1     2021-09-28  jamalh@fabrikam.com  Edit README.md                                  Completed  False      Fabrikam

定义自定义拉取请求视图

筛选 PR 列表有助于查找和组织 PR，以便优先处理工作流中最重要的文件。

浏览器

要筛选 PR 列表，请在“拉取请求”页上选择右上角的“筛选器”图标。 然后选择“目标分支”或其他列标题，并选择要作为筛选依据的分支或其他值。

要进一步自定义 PR 列表视图，请选择“拉取请求”页右上角的“自定义视图”。

在“自定义视图”页上，可以重新排列、编辑或移除当前视图分区。 要创建新分区，请选择“添加分区”。

在“自定义分区”页上，输入并选择值，以按草稿状态或更新日期等参数筛选分区。 可以选择是“在单独的选项卡上显示我已批准或拒绝的拉取请求”，还是“排除前面分区中包含的拉取请求（重复项）”。 完成视图自定义后，选择“保存”。

这些自定义视图在拉取请求页上创建单独的可折叠分区。 这些自定义查询也适用于组织主页的“我的拉取请求”选项卡上的存储库。

要更改自定义视图的参数，请选择视图旁边的“自定义”按钮。 或者选择“自定义视图”，然后在“自定义视图”屏幕上选择要更改的视图。 某些视图（如“分配给我”）无法自定义，但可以重新排列或移除它们。

在 PR 的“文件”选项卡上，可以使用多个筛选器来选择文件和注释，以便加快评审速度。 选择“筛选器”，然后在选项之间进行选择。

• 关键字：输入关键字。
• 已评审/未评审：“全部”（默认值）、“待处理”、“已评审”。
• 已注释的文件：“全部”（默认值）、“带注释的文件”。
• 注释：“显示”（默认值）、“新增内容”、“隐藏”。
• 注释状态：“活动”（默认值）、“待处理”、“已解决”、“保留原样”、“不可修复”、“已关闭”。
• 注释者：“所有注释”（默认值）或特定人员。

还可以在“搜索”字段中键入字符串，以显示上述选项的匹配结果。

Visual Studio

在 Visual Studio 中筛选拉取请求：

1. 在“Git”菜单中，选择“<你的 Git 服务>”>“查看拉取请求”。

2. 按“作者”、“标签”或其他属性进行筛选。

从团队资源管理器“拉取请求”视图中：

• 选择“活动”或“分配给我或我的团队”，按 PR 状态或分配筛选 PR 列表。
• 或者，在“在此处键入以筛选列表”字段中键入，以按日期、作者、分支或其他属性筛选 PR 列表。

Azure DevOps CLI

可以使用多个 az repos pr list 参数来筛选 PR 列表，例如 --creator、--project、--repository、--reviewer、--source-branch、--status、--target-branch 和 --top。

--creator 和 --reviewer 值可以是显示名称或电子邮件地址。 --top 参数定义要列出的最大 PR 数。

例如，要列出有关创建的上一个 PR（无论其状态如何）的详细信息，请使用：

az repos pr list --creator "My Name" --status all --top 1

打开拉取请求

使用浏览器、Visual Studio 或 Azure CLI 中打开 PR 时，会在浏览器中打开 PR 的“概述”页。

浏览器

要在浏览器中打开 PR，请从“拉取请求”页上的列表中选择 PR。 PR 打开到其“概述”选项卡。“概述”选项卡上显示 PR 标题、说明、审阅者、链接的工作项、历史记录和状态。 可以查看通过或失败的分支策略摘要，并查看审阅者进行的注释。

在 PR“文件”选项卡上，可以查看 PR 文件中的实际更改。 在“更新”和“提交”选项卡上，可以看到作者为更新 PR 分支进行的更改。

Visual Studio

要使用 Visual Studio 打开拉取请求，请在“Git”菜单中选择“<你的 Git 服务>”>“查看拉取请求”，然后选择一个拉取请求将其打开。

或者，在团队资源管理器“拉取请求”视图中，右键单击 PR，然后选择“在浏览器中打开”，在 Web 门户中打开 PR。

签出分支

在 Visual Studio 2019 中，可以直接从“拉取请求”视图签出 PR 的源分支。 右键单击 PR，然后选择“签出源分支”。

注意

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

Azure DevOps CLI

要显示单个 PR 的详细信息，请使用 az repos pr show 和必需的 --id 参数。 要在浏览器中打开 PR，请使用 --open。

az repos pr show --id
                 [--detect {false, true}]
                 [--open]
                 [--org]
                 [--query-examples]
                 [--subscription]

参数

参数	说明
--id	拉取请求的 ID。 “必需”。
--detect	自动检测组织。 接受的值：false、true。
--open	在 Web 浏览器中打开拉取请求。
--org --organization	Azure DevOps 组织 URL。 可以使用 az devops configure -d organization=<ORG_URL> 配置默认组织。 如果未配置为默认或未通过 git 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。
--query-examples	建议的 JMESPath 字符串。 可以复制其中一个查询，并将其粘贴到 --query 参数后，置于双引号中，以查看结果。 可以添加一个或多个位置关键字，以便根据这些关键字提供建议。
--subscription	Azure 订阅的名称或 ID。 可以使用 az account set -s <NAME_OR_ID> 配置默认订阅。

示例

以下示例显示了 PR #21 的详细信息，将命令输出显示为表格，并在浏览器中打开了 PR：

az repos pr show --id 21 --open --output table

ID    Created     Creator              Title                         Status    IsDraft    Repository
----  ----------  -------------------  ----------------------------  --------  ---------  ------------
21    2021-10-31  jamalh@fabrikam.com  Updated note-new-git-tool.md  Active    False      Fabrikam

签出分支

结合使用 az repos pr checkout 和必需的 --id 参数，以在本地签出 PR 分支，前提是没有进行本地更改。

az repos pr checkout --id
                     [--remote-name]
                     [--subscription]

参数

参数	说明
--id	拉取请求的 ID。
--remote-name	针对其引发 PR 的 git remote 的名称。 默认值：origin。
--subscription	Azure 订阅的名称或 ID。 可以使用 az account set -s <NAME_OR_ID> 配置默认订阅。

示例

例如，要在本地签出 PR #21 的分支，请使用：

az repos pr checkout --id 21

要查看更改、进行注释、提出建议，或者批准 PR 或对其进行投票，请参阅评审拉取请求。

使用移动设备查看和更新拉取请求

可以使用移动设备查看所有 Azure Repos PR 屏幕并执行操作。

后续步骤

审阅拉取请求

相关文章

• 创建拉取请求
• 拉取请求更新通知
• 完成拉取请求
• 更改默认分支
• 通过挑拣复制更改
• 关于拉取请求和权限