跳至主要内容
版本:1.23.8

拉取請求

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

建立拉取請求

要建立 PR,您需要按照以下步驟操作:

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

  2. 建立分支(可選) - 在您的分叉儲存庫中建立一個包含您要提議的更改的新分支。 給分支起一個描述性名稱,表明更改的用途。

  3. 進行更改 - 進行您想要的更改,提交並推送到您的分叉儲存庫。

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

審查拉取請求

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

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

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

關閉拉取請求

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

“進行中”拉取請求

將拉取請求標記為進行中將防止該拉取請求被意外合併。 要將拉取請求標記為進行中,您必須在其標題前加上 WIP:[WIP](不區分大小寫)。 這些值可以在您的 app.ini 文件中設定:

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

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

拉取請求模板

您可以在 問題和拉取請求模板 頁面找到有關拉取請求模板的更多資訊。