跳至主要内容
版本:1.23.6

拉取請求

拉取請求(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]

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

拉取請求模板

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