CLion 2026.1 Help

审查传入的 GitHub 拉取请求

拉取请求用于开源项目或一些企业工作流程中,以管理贡献者的更改,并在这些更改合并之前启动代码审查。

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

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

  2. 提交您的注释和建议

  3. 合并或关闭该拉取请求

管理传入的 pull requests

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

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

GitHub Pull Requests 工具窗口

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

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

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

  • 跳转到 GitHub 上的拉取请求 :选择一个拉取请求并从上下文菜单中选择 在浏览器中查看拉取请求

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

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

在此视图中,您可以:

  • 查看所选拉取请求的时间线以跟踪其进度。

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

  • 基于传入更改创建本地分支 :打开拉取请求,点击带有传入更改的分支,并在上下文菜单中选择 签出 'branch name'

要详细了解更多选项,请参阅 审核 pull request

审核 pull request

当有需要您注意的更改时, 拉取请求 工具窗口将会出现一个白色点,未查看的 pull requests 将用蓝点标记。

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

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

    CLion 打开所选 pull request 的概述。

    选定拉取请求的概览选项卡
    • 标题旁边是拉取请求编号。 如果您想在 GitHub 上打开 pull request,请点击此处。

    • 点击 查看时间线 后,将打开一个新选项卡,显示该拉取请求的进展情况和对整个拉取请求的高级评论。

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

    • 右键点击任何文件以打开该文件的上下文菜单。

    • 如果存在任何注释或建议,文件列表中将显示一个显示注释数量的计数器。

  3. 要开始审核,请点击包含传入更改的分支,并在上下文菜单中选择 签出 'branch name'

    签出具有传入更改的分支

    通过签出分支,您可以获得完整上下文,以测试传入更改并检查其运行效果。

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

  4. 选择您想要调查的文件,右键点击它并从上下文菜单中选择 跳转到源 F4

    在打开的文件中,边栏中的粉色标记指示可供审查的更改和评论。

    点击边栏中的评论图标将隐藏或打开评论。

    审查模式中的更改和评论

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

    审查模式 - 查看差异
  5. 将鼠标悬停在边栏上并点击 以留下评论。

    带有建议的评论字段
    • 选择 添加单个评论 立即发布评论,并通知其他审阅者。

    • 选择 开始审查 添加多条注释。

      在您提交审查前,您的注释将被标记为 待处理 ,您可以编辑或删除它们。

      包含点赞回应的注释

    要对多行进行评论,可以点击 并拖动蓝色边框以覆盖所需范围,或者先高亮文本然后点击

    如有建议,请将您的代码版本添加在以 suggestion 指定的 Markdown 代码块中。

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

    通过使用顶部工具栏中的 上移按钮/下移按钮 图标,或按下 Ctrl+Alt+Up/Ctrl+Alt+Down 键,可在注释之间导航。

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

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

    或者,打开VCS微件并点击 提交审查

    请选择其中一个可能的结果:

    • 批准 :批准合并更改。

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

    • 注释 :提交评论无需审批。

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

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

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

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

  3. 在概览底部,有一个合并选项按钮,该按钮的选项因审查流程的阶段和您的推送权限不同而有所区别。

    具有合并选项的拉取请求概览
    • 如果您在审核后批准了更新,您可以通过点击 合并 来合并 pull request。

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

    • 点击 更多 ,如果需要对此 pull request 请求另一个意见,请选择 请求审查 ;如果不想合并,请选择 关闭拉取请求

    • 如果您准备在不提交审查的情况下合并 pull request,请在 pull request 概览中点击 更多 | 合并审核 并选择 合并压缩并合并Rebase

      提交审查前可用的合并选项
  4. 当拉取请求被合并后,你可以在拉取请求时间线的选项卡中删除合并的分支。

    如有需要,你可以使用在同一时间线视图中删除后出现的浏览器链接恢复已删除的分支。

2026年 3月 24日