mirror of
https://gitea.com/gitea/docs.git
synced 2026-09-18 03:58:52 +00:00
965c269495
--------- Co-authored-by: silverwind <[email protected]> Co-authored-by: silverwind <[email protected]> Reviewed-on: https://gitea.com/gitea/docs/pulls/455 Reviewed-by: silverwind <[email protected]>
61 lines
2.3 KiB
Markdown
61 lines
2.3 KiB
Markdown
---
|
|
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) 頁面找到有關拉取請求模板的更多資訊。
|