查看、筛选和打开拉取请求
本文内容
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，请成为 Azure DevOps Project 的成员，并且至少具有基本 访问权限。 如果你不是项目成员，请添加为成员 。
列出拉取请求
可以使用 Azure DevOps 项目网站、Visual Studio 或 Azure DevOps 命令行列出 PR。
要列出项目中特定存储库中的 PR，请在 Web 门户中转到该项目 ，然后选择“Repos”>“拉取请求”。
验证是否选择了正确的存储库。
默认视图在“我的”选项卡下显示你的 PR。选择“活动”可显示当前存储库的所有活动 PR。 选择“已完成”或“已放弃”可显示已关闭的 PR 列表。
选择列表中的任何 PR 可转到该 PR 的“概述”页。
通过在“我的工作”视图中选择“拉取请求”，可以列出组织中不同项目的所有 PR。
若要列出 Visual Studio 中的拉取请求，请在“Git ”菜单中，选择 <Git 服务> >查看拉取请求 。
Visual Studio 2019 版本 16.8 及更高版本提供 Git 版本控制体验，同时维护 Team Explorer Git 用户界面。 若要使用 团队资源管理器 ，请从菜单栏中取消选中 工具 >选项 >预览功能 >新的 Git 用户体验。 可以从任意一个接口交替使用 Git 功能。
若要从 Visual Studio 团队资源管理器访问 PR，请执行以下操作：
从 Visual Studio 连接到你的项目 。
选择“查看”>“团队资源管理器”，打开团队资源管理器。 还可以按 Ctrl、Ctrl，Ctrl M 。
从“主页”中选择“拉取请求”，查看由你打开或分配给你的 PR 列表。
若要查看 Azure DevOps Web 门户中的 PR 列表，请选择 操作 ，然后选择 在浏览器 中打开。
要列出项目中的活动 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--organizationAzure 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。
--subscriptionAzure 订阅的名称或 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
Azure DevOps CLI 命令不支持 Azure DevOps Server。
定义自定义拉取请求视图
筛选 PR 列表有助于查找和组织 PR，以便确定工作流中最重要的文件的优先级。
若要筛选 PR 列表，请在 拉取请求 页上，选择右上角的 筛选器 图标。 然后选择 目标分支 或其他列标题，然后选择要筛选的分支或其他值。
要进一步自定义 PR 列表视图，请选择“拉取请求”页右上角的“自定义视图”。
在 自定义视图 页上，可以重新排列当前视图部分、编辑或删除它们。 若要创建新分区，请选择“添加分区”
在“自定义分区”页上，输入并选择值，以按草稿状态或更新日期等参数筛选分区。 可以选择是“在单独的选项卡上显示我已批准或拒绝的拉取请求”，还是“排除前面分区中包含的拉取请求（重复项）”。 自定义完视图后，选择 保存 。
这些自定义视图在拉取请求页上创建单独的可折叠部分。 这些自定义查询也可以在组织主页的 “我的拉取请求” 选项卡中跨存储库使用。
若要更改自定义视图的参数，请选择视图旁边的 “自定义 ”按钮。 或者选择 自定义视图 ，然后在 “自定义视图” 屏幕上，选择要更改的视图。 某些视图（如 分配给我 ）无法自定义，但可以重新排列或删除它们。
在 PR 的“文件”选项卡上，可以使用多个筛选器来选择文件和注释，以便加快评审速度。 选择 筛选器 ，然后在选项之间进行选择。
关键字：输入关键字。
已评审/未评审：“全部”（默认值）、“待处理”、“已评审”。
已注释的文件：“全部”（默认值）、“带注释的文件”。
注释：“显示”（默认值）、“新增内容”、“隐藏”。
注释状态：“活动”（默认值）、“待处理”、“已解决”、“保留原样”、“不可修复”、“已关闭”。
注释者：“所有注释”（默认值）或特定人员。
还可以在“搜索”字段中键入字符串，以显示上述选项中的匹配结果。
若要筛选来自 Visual Studio 的拉取请求，请执行以下操作：
在“Git”菜单中，选择“<你的 Git 服务>”>“查看拉取请求”。
按 作者 、标签 或其他属性进行筛选。
从团队资源管理器“拉取请求”视图中：
选择“活动”或“分配给我或我的团队”，按 PR 状态或分配筛选 PR 列表。
或者，在“在此处键入以筛选列表”字段中键入，以按日期、作者、分支或其他属性筛选 PR 列表。
可以使用多个 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
Azure DevOps CLI 命令不支持 Azure DevOps Server。
打开拉取请求
从浏览器、Visual Studio 或 Azure CLI 打开 PR 时，会在浏览器中打开 PR 概述 页。
要在浏览器中打开 PR，请从“拉取请求”页上的列表中选择 PR。 PR 打开到其“概述”选项卡。“概述”选项卡上显示 PR 标题、说明、审阅者、链接的工作项、历史记录和状态。 可以查看分支策略是否通过或失败的摘要，并查看审阅者所做的评论。
在“PR 文件 ”选项卡上，可以查看 PR 文件中的实际更改。 在“更新”和“提交”选项卡上，可以看到作者为更新 PR 分支进行的更改。
若要从 Visual Studio 打开拉取请求，请在 Git 菜单中，选择 <您的 Git 服务> >查看拉取请求 ，然后选择一个拉取请求以打开它。
或者，在团队资源管理器“拉取请求”视图中，右键单击 PR，然后选择“在浏览器中打开”，在 Web 门户中打开 PR。
签出分支
在 Visual Studio 2019 中，可以直接从“拉取请求”视图签出 PR 的源分支。 右键单击 PR，然后选择“签出源分支”。
显示签出源分支的
备注
Visual Studio 2019 版本 16.8 及更高版本提供了一个新的 Git 菜单，用于管理 Git 工作流，其上下文切换比团队资源管理器少。 本文在 Visual Studio 选项卡下提供的过程提供了有关使用 Git 体验以及团队资源管理器的信息。 有关详细信息，请参阅 Git 和团队资源管理器 并行比较。
要显示单个 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--organizationAzure DevOps 组织 URL。 可以使用 az devops configure -d organization=<ORG_URL>配置默认组织。 如果未配置为默认或未通过 git 配置选取，则为必需 。示例：https://dev.azure.com/MyOrganizationName/。
--query-examples建议的 JMESPath 字符串。 可以复制其中一个查询，并将其粘贴到 --query 参数后，用双引号查看结果。 可以添加一个或多个位置关键字，以便建议基于这些关键字。
--subscriptionAzure 订阅的名称或 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。
--subscriptionAzure 订阅的名称或 ID。 可以使用 az account set -s <NAME_OR_ID>配置默认订阅。
例
例如，若要在本地查看 PR #21 的分支，请使用：
az repos pr checkout --id 21
Azure DevOps CLI 命令不支持 Azure DevOps Server。
要查看更改、进行注释、提出建议，或者批准 PR 或对其进行投票，请参阅评审拉取请求 。
使用移动设备查看和更新拉取请求
可以使用移动设备查看所有 Azure Repos PR 屏幕并采取措施。
后续步骤
相关文章
