mirror of
https://gitea.com/gitea/docs.git
synced 2025-05-11 14:35:06 +00:00
dbfa0ba454
Signed-off-by: appleboy <appleboy.tw@gmail.com> Reviewed-on: https://gitea.com/gitea/docs/pulls/195 Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com> Co-authored-by: appleboy <appleboy.tw@gmail.com> Co-committed-by: appleboy <appleboy.tw@gmail.com>
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.md) 頁面找到有關拉取請求模板的更多信息。
|