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

# 拉取請求

拉取請求（PR）是一種提議對倉庫進行更改的方法。
它是一個請求，要求將一個分支合併到另一個分支，並附有對所做更改的描述。
拉取請求通常用於貢獻者提議更改，並由維護者審查和合併這些更改。

## 創建拉取請求

要創建 PR，您需要按照以下步驟操作：

1. **分叉倉庫** - 如果您沒有直接更改倉庫的權限，您需要將倉庫分叉到自己的帳戶。
   這會創建一個您可以進行更改的倉庫副本。

2. **創建分支（可選）** - 在您的分叉倉庫中創建一個包含您要提議的更改的新分支。
   給分支起一個描述性名稱，表明更改的用途。

3. **進行更改** - 進行您想要的更改，提交並推送到您的分叉倉庫。

4. **創建 PR** - 轉到原始倉庫並轉到“拉取請求”選項卡。點擊“新建拉取請求”按鈕，選擇您的新分支作為源分支。
   為您的拉取請求輸入描述性標題和描述，然後點擊“創建拉取請求”。

## 審查拉取請求

創建 PR 後，會觸發審查過程。倉庫的維護者會收到 PR 的通知，並可以審查所做的更改。
他們可以留下評論、請求更改或批准更改。

如果維護者請求更改，您需要在您的分支中進行這些更改，並將更改推送到您的分叉倉庫。
PR 將自動更新為新更改。

如果維護者批准更改，他們可以將 PR 合併到倉庫中。

## 關閉拉取請求

如果您決定不再想合併 PR，您可以關閉它。
要關閉 PR，請轉到打開的 PR，然後點擊“關閉拉取請求”按鈕。這將關閉 PR 而不合併它。

## “進行中”拉取請求

將拉取請求標記為進行中將防止該拉取請求被意外合併。
要將拉取請求標記為進行中，您必須在其標題前加上 `WIP:` 或 `[WIP]`（不區分大小寫）。
這些值可以在您的 `app.ini` 文件中配置：

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

列表中的第一個值將用於幫助程序。

## 拉取請求模板

您可以在 [問題和拉取請求模板](usage/issue-pull-request-templates.md) 頁面找到有關拉取請求模板的更多信息。