---
date: "2018-06-01T19:00:00+02:00"
slug: "pull-request"
sidebar_position: 13
aliases:
  - /zh-tw/pull-request
---

# 合並請求

合並請求(PR)是一种提出对存放庫進行更改的方式。
它是一种将一个分支合並到另一个分支的請求，附带有对所做更改的描述。
合並請求通常用作贡献者对存放庫贡献代码的方式，存放庫的维护者可以通過对合並請求進行审查来决定是否接受这些更改。

## 建立合並請求

要建立合並請求，您需要遵循以下步骤：

1. **Fork 存放庫** - 如果您没有直接对存放庫進行更改的权限，您需要将存放庫 fork 到您自己的账户中。
   这将建立一个您可以对其進行更改的存放庫副本。

2. **建立分支（可選）** - 在 fork 的存放庫中建立一个新分支，該分支包含您要提出的更改。
   给分支取一个描述性的名稱，以指示更改的内容。

3. **進行更改** - 進行您想要的更改，提交並将其推送到 fork 的存放庫中。

4. **建立合並請求** - 转到原始存放庫並转到“合並請求”選项卡。單擊“新建合並請求”按钮，並将您的新分支選择為源分支。
   為您的合並請求输入描述性标题和描述，然后單擊“建立合並請求”。

## 评审合並請求

建立合並請求后，将触发评审流程。存放庫的维护者将收到合並請求的通知，並可以审查所做的更改。
他们可以留下评论、請求更改或批准更改。

如果维护者請求更改，您需要在分支中進行这些更改，並将更改推送到 fork 的存放庫中。
合並請求将自动使用新更改進行更新。

如果维护者批准更改，他们可以将合並請求合並到存放庫中。

## 关闭合並請求

如果您不接受該合並請求，您可以关闭它。
要关闭合並請求，請转到打开的合並請求並單擊“关闭合並請求”按钮。这将关闭合並請求並且不会将其合並。

## 使用“Work In Progress”标记

在合並請求中使用“Work In Progress”标记可以防止合並請求被意外合並。
要将合並請求标记為“Work In Progress”，您必須在其标题中添加前缀`WIP:`或`[WIP]`（不区分大小写）。
标记前缀可以在您的`app.ini`文件中進行配置：

```
[repository.pull-request]
WORK_IN_PROGRESS_PREFIXES=WIP:,[WIP]
```

列表的第一个值将用于 helpers 程序。

## 合並請求模板

有关合並請求模板的更多信息請您移步 : [工單与合並請求模板](usage/issue-pull-request-templates.md)
