审查传入的 GitHub 拉取请求
拉取请求用于开源项目或某些企业工作流中,以管理贡献者的更改,并在合并此类更改之前发起代码审查。
您可能会收到来自同事或其他贡献者的代码更改审查请求。 作为拉取请求审查者,您可以直接在 PyCharm 中提供反馈:
在 拉取请求 工具窗口中, 选择待处理的审查请求。
管理传入的拉取请求
如果您是项目维护者,并且已为项目配置了 GitHub 远程,则可以直接在 PyCharm 中查看和管理传入的拉取请求。
要打开 拉取请求 工具窗口,请在主菜单中选择 。

在 拉取请求 工具窗口中,您可以:
筛选请求 ,按状态、作者、标签、受理人和审查状态。
排序 拉取请求,按其活动状态:最新、最旧、评论最多或最少、最近更新或最久未更新。
跳转到 GitHub 上的拉取请求 :选择一个拉取请求,然后在上下文菜单中选择 在浏览器中打开拉取请求。
在列表中双击某个拉取请求,您可以看到概览和时间线选项卡。

在此视图中,您可以:
在所选拉取请求中, 查看时间线 ,以跟踪其进展。
选择特定提交 ,以筛选更改列表。
创建本地分支 (基于传入更改):打开拉取请求,点击包含传入更改的分支,然后在上下文菜单中选择 检出 '分支名称'。
要了解更多选项,请参阅 审查拉取请求。
审查拉取请求
当有需要您关注的更改时, 拉取请求 工具窗口上会显示白点,未查看的拉取请求会以蓝点标记。

在主菜单中,转到 。
在拉取请求列表中,选择您要处理的请求并双击它。
PyCharm 会打开所选拉取请求的概览。

标题旁边有拉取请求编号。 如需在 GitHub 上打开该拉取请求,请点击该编号。
当您点击 查看时间线 时,将打开一个新选项卡,显示拉取请求的进展以及针对整个拉取请求的总体评论。
要筛选更改的文件列表,请在 更改来源 中选择您要检查的提交。
在任意文件上点击鼠标右键以打开该文件的上下文菜单。
如有评论或建议,文件列表中会显示一个计数器,显示评论数量。
要开始您的审查,请点击包含传入更改的分支,然后在上下文菜单中选择 检出 '分支名称'。

通过检出该分支,您将获得完整上下文,以测试传入的更改并检查其工作方式。
检出成功后,PyCharm 会启动 审查模式。 这意味着,您不仅可以在 Diff 选项卡(Ctrl+D )中看到高亮显示的更改和评论,还可以直接在编辑器(F4 )中查看。
选择您要检查的文件,右键点击该文件,并在上下文菜单中选择 跳转到源 F4。
在打开的文件中,装订区域中的粉色标记表示可供审查的更改和评论。
点击装订区域中的评论图标可隐藏或显示评论。

点击粉色标记会显示一个弹出窗口,展示原始代码。

将鼠标悬停在装订区域上,然后点击
以留下评论。

选择 添加单条评论 可立即发布评论,并通知其他审查者。
选择 开始审查 以添加多条评论。
在提交审查之前,您的评论会标记为 待处理 ,您可以编辑或删除它们。

对于建议,请将您的代码版本包裹在 Markdown 代码块中,并将
suggestion指定为语言。```suggestion Your suggestion for this code line ```使用顶部工具栏中的
/
,或按下 Ctrl+Alt+Up/Ctrl+Alt+Down ,在评论之间导航。
准备完成审查时,请在拉取请求概览中点击 提交。

或者,打开分支弹出窗口并点击 提交审查。
选择以下结果之一:
批准 :批准合并更改。
请求更改 :提交反馈,拉取请求作者必须在合并前应用建议的更改。
评论 :提交评论但不予批准。
合并或关闭传入的拉取请求
如果您对存储库具有推送访问权限,在提交审查并解决所有问题后,您可以合并或关闭拉取请求。
在主菜单中,转到 。
在拉取请求列表中,选择您要处理的请求并双击它。
在概览底部,有一个包含合并选项的按钮,这些选项会根据审查流程的阶段以及您的推送访问权限而有所不同。

如果您在审查后已批准更新,可以点击 合并 合并该拉取请求。
如需更多合并选项,请点击
,然后选择 压缩并合并 以在合并前将包含您更改的提交压缩为一个提交,或选择 变基 以将拉取请求分支中的提交变基并添加到基准分支。
点击
更多 ,若您需要对此拉取请求的其他意见,请选择 请求审查 ;若不想合并,请选择 关闭拉取请求。
如果您准备在不提交审查的情况下合并该拉取请求,请在拉取请求概览中点击
,并选择 合并、 压缩并合并 或 变基。
