DataGrip 2025.2 Help

使用 GitHub pull requests

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

通过创建拉取请求,您可以告知其他人您希望推送到原始存储库的更改,以便该存储库的维护者可以审查您的更改、讨论并将其集成到基础分支中。

创建拉取请求

  1. 在主菜单中,进入 Git | GitHub | 创建拉取请求. 拉取请求 工具窗口打开后会显示一个拉取请求草稿。

    带有新 pull request 的 Pull Requests 工具窗口

    或者,打开 拉取请求 工具窗口并点击右上角的 Plus创建拉取请求…。

  2. 左侧的存储库是将接收更新的 基础存储库。

    点击其名称并选择您希望应用更改的分支。

    基础仓库弹窗
  3. 右侧的代码库是将更改添加到基本代码库中的 head代码库。

    点击其名称并选择包含您希望应用的更改的分支。

    代码库选项弹出窗口

    如果您有一个使用 多个远程存储库 的项目,您也可以在此弹出窗口中更改主存储库。

  4. 在 变更来源 中,选择您希望包含在拉取请求中的提交。

  5. 双击任何文件的名称以打开差异视图并审查您即将提交的更改。

  6. 请在 标题 字段中指定您的 pull request 的名称,并且可以选择性地提供通过您的请求应用的更改描述。

  7. 可选地添加审阅者,将您的 pull request 分配给某人,或向您的 pull request 添加标签。

  8. 点击 创建拉取请求。

    如果您还没有准备好推送您的 pull request,可以将其保存为草稿。

    • 点击 向下小箭头 按钮旁边的 创建拉取请求。

    • 在打开的菜单中,选择 创建草稿拉取请求。

    您的 pull request 将作为草稿出现在 GitHub 仓库中。 您可以稍后通过在主菜单中选择 Git | GitHub | 查看拉取请求 返回到它。

如果您有一个 pull_request_template.md 文件,DataGrip 应该将模板描述添加到您的 pull requests 中。 有关模板的更多信息,请参阅 GitHub 文档。

管理传入的 pull requests

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

要查看传入的 pull requests,请在主菜单中选择 Git | GitHub | 查看拉取请求。

GitHub Pull Requests 工具窗口

使用 拉取请求 工具窗口来:

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

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

  • 查看差异 在建议更改和基准修订版之间:点击拉取请求的名称,选择一个文件,然后双击它或按 Ctrl+D。

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

    从传入更改中检出分支
  • 调查分支相关变更 在 日志 选项卡中的 Git 工具窗口:打开一个拉取请求,点击带有传入更改的分支,并在上下文菜单中选择 在 Git Log 中显示 'branch name'。

    这将帮助您浏览与此 pull request 相关的代码,确保项目构建并且测试通过。

  • 解决合并冲突 :如果传入拉取请求中的分支存在合并冲突,您可以直接从 拉取请求 工具窗口解决它们,方法是从目标分支创建合并提交或重新基于目标分支。

    解决合并冲突的选项

为了确保您始终拥有关于拉取请求的最新信息,请按 Ctrl+F5。 或者,右键点击拉取请求列表并选择 刷新列表。

审核 pull request

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

点表示未查看的请求
  1. 在主菜单中,进入 Git | GitHub | 查看拉取请求.

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

    DataGrip 打开所选 pull request 的概述。

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

    • 点击 查看时间线 按钮以打开拉取请求时间线。

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

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

    • 如果审核员留下了任何评论或建议,文件列表中会有一个计数器显示评论数量。

  3. 点击包含传入更改的分支并在上下文菜单中选择 签出 'branch name' 以启动审查模式。

    从传入更改中检出分支
  4. 双击您想要调查的文件。

  5. 在打开的差异查看器中,将鼠标悬停在边距上并单击 以留下评论。

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

    ```suggestion Your suggestion for this code line ```
    带有建议的评论字段
    • 选择 添加单条评论 立即发布评论,并通知其他审阅者。

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

      在您提交评论前,您的评论将被标记 待处理 ,您可以编辑或删除它们。

  6. 要对整个拉取请求放置高级备注,请打开此拉取请求的时间线视图。

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

    点击提交后的三种结果

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

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

    • 批准 :批准合并更改。

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

    • Comment :提交评论无需审批。

查看并应用建议的更改

如果原始代码库的维护者对您的更改留下了评论或提出了建议,您可以直接从 DataGrip 查看并应用它们。

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

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

    DataGrip 打开所选 pull request 的概述。

  3. 双击文件以查看建议的更改和评论。

  4. 您可以解决评论、回复评论或留下您的反应。

    GitHub 审查评论
  5. 如果审查员提出了建议,您将看到您的代码与建议代码之间的差异,并可以 本地应用 (将补丁应用到工作副本)或 Commit (打开提交消息弹出窗口)。

    GitHub 建议更改在本地应用
  6. 当您完成对拉取请求的处理后,您可以重新请求审查、合并拉取请求或关闭它。

合并或关闭 pull request

提交您的评审并解决所有问题后,您可以合并或关闭该 pull request。

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

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

  3. 在概览的底部,有一个按钮包含合并选项,这些选项根据审查过程的阶段而有所不同。

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

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

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

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

      提交审查前可用的合并选项
最后修改日期: 2025年 9月 26日