# 创建并合并 GitHub 拉取请求

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

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

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

作为拉取请求的作者，您可以直接在 CLion 中管理拉取请求的生命周期：

1.  [创建](#create-pull-request) 一个拉取请求。

2.  [查看您的拉取请求的详细信息](#pull-requests-tool-window) 在   拉取请求   工具窗口中。

3.  [处理审阅者的反馈和注释](#work-with-received-feedback)。

4.  [合并或关闭](#merge-a-pull-request) 您的拉取请求。

> **Tip:**
> 要了解如何对拉取请求提供反馈，请参阅 [审查传入的 GitHub 拉取请求](work-with-github-pull-requests.html)。

## 创建拉取请求

Procedure:

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

![带有新 pull request 的 Pull Requests 工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/pull_requests_tool_window.png)

或者，打开   拉取请求   工具窗口并点击右上角的 ![Plus](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)   创建拉取请求…  。

> **Tip:**
> 将更改推送到远程仓库后，CLion 会向您显示一条通知，提供打开新 pull request 的选项。

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

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

![基础仓库弹窗](https://resources.jetbrains.com/help/img/idea/2026.3/base_repo_popup.png)

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

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

![代码库选项弹出窗口](https://resources.jetbrains.com/help/img/idea/2026.3/head_repo_popup.png)

如果您有一个使用 [多个远程存储库](set-up-a-git-repository.html#add-second-remote) 的项目，您也可以在此弹出窗口中更改主存储库。

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

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

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

7. 点击   创建拉取请求  。

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

* 点击 ![向下小箭头](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.chevronDown.svg)按钮旁边的 创建拉取请求 。

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

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

如果您有一个  `pull_request_template.md`  文件，CLion 应该将模板描述添加到您的 pull requests 中。 有关模板的更多信息，请参阅 [GitHub 文档](https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/creating-a-pull-request-template-for-your-repository)。

## 查看您的拉取请求的详细信息

创建拉取请求后，您始终可以在   拉取请求   工具窗口中找到它。

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

![GitHub Pull Requests 工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/incoming_pull_requests.png)

在   拉取请求   工具窗口中，您可以：

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

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

* 跳转到 GitHub 上的拉取请求 ：选择一个拉取请求并从上下文菜单中选择 在浏览器中视图拉取请求 。

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

![包含已打开拉取请求的 Pull Requests 选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/pull_request_options.png)

在此视图中，您可以：

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

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

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

要详细了解更多选项，请参阅 [审核 pull request](work-with-github-pull-requests.html#provide-feedback)。

> **Tip:**
> 为了确保您始终拥有关于拉取请求的最新信息，请按 `Ctrl+F5` (Windows), `⌘ R` (macOS), `⌃ F5` (IntelliJ IDEA Classic (macOS)), `⌘ R` (macOS System Shortcuts), `Ctrl+F5` (XWin), `Ctrl+F5` (GNOME), `Ctrl+5` (KDE), `Ctrl+F5` (Emacs), `Ctrl+F5` (Sublime Text), `⌘ R` (Sublime Text (macOS)), `⌘ R` (Xcode), `Ctrl+Alt+R` (Visual Studio), `⌘ ⌥ R` (Visual Studio (macOS)), `Ctrl+F5` (ReSharper), `Ctrl+F5` (ReSharper (macOS)), `Ctrl+F5` (QtCreator), `Ctrl+F5` (QtCreator (macOS)), `Ctrl+F5` (NetBeans), `Ctrl+F5` (Eclipse), `Ctrl+F5` (Eclipse (macOS))。 或者，右键点击拉取请求列表并选择   刷新列表  。

## 处理收到的反馈

当您将拉取请求发送进行审查时，您可能会收到有关更改的注释或建议。 您可以直接从 CLion 查看并应用它们。

Procedure:

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

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

CLion 打开所选 pull request 的概述。

![拉取请求概览](https://resources.jetbrains.com/help/img/idea/2026.3/pr_overview_with_timeline.png)

3. 点击包含传入更改的分支，并在上下文菜单中选择   签出 'branch name'  。

![拉取请求概览中的检出选项](https://resources.jetbrains.com/help/img/idea/2026.3/check_out_pr_branch.png)

通过检出分支，您可以获得完整上下文，以测试审阅者建议的更改并检查其效果。

签出成功后，CLion 将启动  审查模式 。 这意味着您不仅可以在 Diff 选项卡（ `Ctrl+D` (Windows), `⌘ D` (macOS), `⌘ D` (IntelliJ IDEA Classic (macOS)), `⌘ D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Ctrl+D` (Emacs), `Ctrl+D` (Sublime Text), `⌘ D` (Sublime Text (macOS)), `⌘ D` (Xcode), `Ctrl+D` (Visual Studio), `⌘ D` (Visual Studio (macOS)), `Ctrl+D` (ReSharper), `⌘ D` (ReSharper (macOS)), `Ctrl+D` (QtCreator), `⌘ D` (QtCreator (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Eclipse), `⌘ D` (Eclipse (macOS))）中看到高亮显示的更改和注释，还可以直接在编辑器（ `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))）中查看。

> **Note:**
> 您可以在编辑器右上角点击   审查模式  配置审查模式或禁用它。
>
>
>
> ![带有选项的弹出窗口](https://resources.jetbrains.com/help/img/idea/2026.3/disable_review_mode.png)
>
> 还可以自定义用于指示变更行的颜色，在  `设置 | 编辑器 | 配色方案 | 代码审查` 。

4. 选择您想要调查的文件，右键点击它并从上下文菜单中选择   跳转到源   `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))。

在打开的文件中，装订区域中的粉色标记表示您所做的更改和审阅者留下的注释。

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

通过使用顶部工具栏中的 ![上移按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.up.svg) / ![下移按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.down.svg) 图标，或按下 `Ctrl+Alt+Up` (Windows), `⌘ ⌥ ↑` (macOS), `⌘ ⌥ ↑` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ↑` (macOS System Shortcuts), `Ctrl+Alt+Up` (XWin), `Alt+Shift+Up` (GNOME), `Ctrl+Alt+Up` (KDE), `Ctrl+Alt+Up` (Emacs), `Ctrl+Alt+Up` (Sublime Text), `Ctrl+Alt+Up` (Sublime Text (macOS)), `⌃ ↑` (Xcode), `Ctrl+Alt+Up` (Visual Studio), `⌘ ⌥ ↑` (Visual Studio (macOS)), `Ctrl+Alt+Up` (ReSharper), `⌘ ⌥ ↑` (ReSharper (macOS)), `Ctrl+Alt+Up` (QtCreator), `⌘ ⌥ ↑` (QtCreator (macOS)), `Ctrl+Alt+Up` (NetBeans), `Ctrl+Alt+Up` (Eclipse), `Ctrl+Alt+Up` (Eclipse (macOS)) / `Ctrl+Alt+Down` (Windows), `⌘ ⌥ ↓` (macOS), `⌘ ⌥ ↓` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ↓` (macOS System Shortcuts), `Ctrl+Alt+Down` (XWin), `Alt+Shift+Down` (GNOME), `Ctrl+Alt+Down` (KDE), `Ctrl+Alt+Down` (Emacs), `Ctrl+Alt+Down` (Sublime Text), `Ctrl+Alt+Down` (Sublime Text (macOS)), `⌃ ↓` (Xcode), `Ctrl+Alt+Down` (Visual Studio), `⌘ ⌥ ↓` (Visual Studio (macOS)), `Ctrl+Alt+Down` (ReSharper), `⌘ ⌥ ↓` (ReSharper (macOS)), `Ctrl+Alt+Down` (QtCreator), `Ctrl+Alt+Down` (QtCreator (macOS)), `Ctrl+Alt+Down` (NetBeans), `Ctrl+Alt+Down` (Eclipse), `Ctrl+Alt+Down` (Eclipse (macOS)) 键，可在注释之间导航。

要提及用户，请输入  `@` ，然后从建议弹窗中选择所需的用户名。 添加提及后，可点击它，在浏览器中打开该用户的个人资料。

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

6. 当您完成对拉取请求的处理后，您可以重新请求审查、合并拉取请求或关闭它。

![带有重新请求审查选项的拉取请求工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/pr_workflow_options.png)

## 合并或关闭 pull request

如果您对仓库拥有推送权限，当工作完成后，您可以合并您的拉取请求。

Procedure:

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

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

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

![具有合并选项的拉取请求概览](https://resources.jetbrains.com/help/img/idea/2026.3/gh_merge_pr.png)

* 如果您在审核后批准了更新，您可以通过点击 合并 来合并 pull request。 如需更多合并选项，请点击 ![向下箭头](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.chevronDown.svg) 并选择 压缩并合并 以在合并之前将您的更改的提交压缩为一个，或 Rebase 以从拉取请求分支变基提交并将其添加到基分支。

* 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.actions.more.svg) 更多 ，如果需要对此 pull request 请求另一个意见，请选择 请求审查 ；如果不想合并，请选择 关闭拉取请求 。

* 如果您准备在不提交审查的情况下合并 pull request，请在 pull request 概览中点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.actions.more.svg) `更多 | 合并审核` 并选择 合并 、 压缩并合并 或 Rebase 。 ![提交审查前可用的合并选项](https://resources.jetbrains.com/help/img/idea/2026.3/gh_merge_pr_no_review.png)

4. 当拉取请求被合并后，你可以在拉取请求时间线的选项卡中删除合并的分支。

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

