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

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 具有完全访问权限。

  • 必须在项目上启用 Repos。 如果 Repos 中心和关联页面未显示,请参阅打开或关闭 Azure DevOps 服务以重新启用 Repos。
  • 要查看 PR,必须是 Azure DevOps 项目的成员,具有基本访问级别或更高级别。 如果你不是项目成员,请添加为成员

列出拉取请求

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

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

    展示如何查看拉取请求的屏幕截图。

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

    展示如何选择存储库的屏幕截图。

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

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

    Azure Repos 中 PR 的视图选项卡的屏幕截图。

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

    展示如何查看所有拉取请求的屏幕截图。

定义自定义拉取请求视图

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

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

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

显示“拉取请求”页上的“自定义视图”按钮的屏幕截图。

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

显示“自定义视图”页的屏幕截图,其中包含“添加分区”按钮。

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

显示“自定义分区”页的屏幕截图。

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

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

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

包含筛选器选项的“文件”选项卡的屏幕截图。

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

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

打开拉取请求

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

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

显示 PR“概述”选项卡的屏幕截图。

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

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

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

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

移动设备上 Azure Repos PR 屏幕的屏幕截图。

后续步骤