PyCharm 2025.3 Help

审查传入的 GitHub 拉取请求

拉取请求用于开源项目或某些企业工作流中,以管理贡献者的更改,并在合并此类更改之前发起代码审查。

您可能会收到来自同事或其他贡献者的代码更改审查请求。 作为拉取请求审查者,您可以直接在 PyCharm 中提供反馈:

  1. 拉取请求 工具窗口中, 选择待处理的审查请求

  2. 提交您的评论和建议

  3. 合并或关闭拉取请求

管理传入的拉取请求

如果您是项目维护者,并且已为项目配置了 GitHub 远程,则可以直接在 PyCharm 中查看和管理传入的拉取请求。

要打开 拉取请求 工具窗口,请在主菜单中选择 Git | GitHub | 查看拉取请求

GitHub 拉取请求工具窗口

拉取请求 工具窗口中,您可以:

  • 筛选请求 ,按状态、作者、标签、受理人和审查状态。

  • 排序 拉取请求,按其活动状态:最新、最旧、评论最多或最少、最近更新或最久未更新。

  • 跳转到 GitHub 上的拉取请求 :选择一个拉取请求,然后在上下文菜单中选择 在浏览器中打开拉取请求

在列表中双击某个拉取请求,您可以看到概览和时间线选项卡。

包含已打开拉取请求的拉取请求选项卡

在此视图中,您可以:

  • 在所选拉取请求中, 查看时间线 ,以跟踪其进展。

  • 选择特定提交 ,以筛选更改列表。

  • 创建本地分支 (基于传入更改):打开拉取请求,点击包含传入更改的分支,然后在上下文菜单中选择 检出 '分支名称'

要了解更多选项,请参阅 审查拉取请求

审查拉取请求

当有需要您关注的更改时, 拉取请求 工具窗口上会显示白点,未查看的拉取请求会以蓝点标记。

拉取请求工具窗口图标上的蓝点
  1. 在主菜单中,转到 Git | GitHub | 查看拉取请求

  2. 在拉取请求列表中,选择您要处理的请求并双击它。

    PyCharm 会打开所选拉取请求的概览。

    包含所选拉取请求概览的选项卡
    • 标题旁边有拉取请求编号。 如需在 GitHub 上打开该拉取请求,请点击该编号。

    • 当您点击 查看时间线 时,将打开一个新选项卡,显示拉取请求的进展以及针对整个拉取请求的总体评论。

    • 要筛选更改的文件列表,请在 更改来源 中选择您要检查的提交。

    • 在任意文件上点击鼠标右键以打开该文件的上下文菜单。

    • 如有评论或建议,文件列表中会显示一个计数器,显示评论数量。

  3. 要开始您的审查,请点击包含传入更改的分支,然后在上下文菜单中选择 检出 '分支名称'

    检出包含传入更改的分支

    通过检出该分支,您将获得完整上下文,以测试传入的更改并检查其工作方式。

    检出成功后,PyCharm 会启动 审查模式。 这意味着,您不仅可以在 Diff 选项卡(Ctrl+D )中看到高亮显示的更改和评论,还可以直接在编辑器(F4 )中查看。

  4. 选择您要检查的文件,右键点击该文件,并在上下文菜单中选择 跳转到源 F4

    在打开的文件中,装订区域中的粉色标记表示可供审查的更改和评论。

    点击装订区域中的评论图标可隐藏或显示评论。

    审查模式中的更改和评论

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

    审查模式 - 查看差异
  5. 将鼠标悬停在装订区域上,然后点击 以留下评论。

    包含建议的评论字段
    • 选择 添加单条评论 可立即发布评论,并通知其他审查者。

    • 选择 开始审查 以添加多条评论。

      在提交审查之前,您的评论会标记为 待处理 ,您可以编辑或删除它们。

      带点赞的评论

    对于建议,请将您的代码版本包裹在 Markdown 代码块中,并将 suggestion 指定为语言。

    ```suggestion Your suggestion for this code line ```

    使用顶部工具栏中的 向上按钮/向下按钮 ,或按下 Ctrl+Alt+Up/Ctrl+Alt+Down ,在评论之间导航。

  6. 准备完成审查时,请在拉取请求概览中点击 提交

    点击提交后,会出现三个选项

    或者,打开分支弹出窗口并点击 提交审查

    选择以下结果之一:

    • 批准 :批准合并更改。

    • 请求更改 :提交反馈,拉取请求作者必须在合并前应用建议的更改。

    • 评论 :提交评论但不予批准。

合并或关闭传入的拉取请求

如果您对存储库具有推送访问权限,在提交审查并解决所有问题后,您可以合并或关闭拉取请求。

  1. 在主菜单中,转到 Git | GitHub | 查看拉取请求

  2. 在拉取请求列表中,选择您要处理的请求并双击它。

  3. 在概览底部,有一个包含合并选项的按钮,这些选项会根据审查流程的阶段以及您的推送访问权限而有所不同。

    拉取请求概览及合并选项
    • 如果您在审查后已批准更新,可以点击 合并 合并该拉取请求。

      如需更多合并选项,请点击 向下箭头 ,然后选择 压缩并合并 以在合并前将包含您更改的提交压缩为一个提交,或选择 变基 以将拉取请求分支中的提交变基并添加到基准分支。

    • 点击 更多 ,若您需要对此拉取请求的其他意见,请选择 请求审查 ;若不想合并,请选择 关闭拉取请求

    • 如果您准备在不提交审查的情况下合并该拉取请求,请在拉取请求概览中点击 更多 | 合并审查 ,并选择 合并压缩并合并变基

      在提交审查之前可用的合并选项
最后修改日期: 2025年 12月 2日