拉取請求
拉取請求(PR)是一種提議對倉庫進行更改的方法。 它是一個請求,要求將一個分支合併到另一個分支,並附有對所做更改的描述。 拉取請求通常用於貢獻者提議更改,並由維護者審查和合併這些更改。
創建拉取請求
要創建 PR,您需要按照以下步驟操作:
-
分叉倉庫 - 如果您沒有直接更改倉庫的權限,您需要將倉庫分叉到自己的帳戶。 這會創建一個您可以進行更改的倉庫副本。
-
創建分支(可選) - 在您的分叉倉庫中創建一個包含您要提議的更改的新分支。 給分支起一個描述性名稱,表明更改的用途。
-
進行更改 - 進行您想要的更改,提交並推送到您的分叉倉庫。
-
創建 PR - 轉到原始倉庫並轉到“拉取請求”選項卡。點擊“新建拉取請求”按鈕,選擇您的新分支作為源分支。 為您的拉取請求輸入描述性標題和描述,然後點擊“創建拉取請求”。
審查拉取請求
創建 PR 後,會觸發審查過程。倉庫的維護者會收到 PR 的通知,並可以審查所做的更改。 他們可以留下評論、請求更改或批准更改。
如果維護者請求更改,您需要在您的分支中進行這些更改,並將更改推送到您的分叉倉庫。 PR 將自動更新為新更改。
如果維護者批准更改,他們可以將 PR 合併到倉庫中。
關閉拉取請求
如果您決定不再想合併 PR,您可以關閉它。 要關閉 PR,請轉到打開的 PR,然後點擊“關閉拉取請求”按鈕。這將關閉 PR 而不合併它。
“進行中”拉取請求
將拉取請求標記為進行中將防止該拉取請求被意外合併。
要將拉取請求標記為進行中,您必須在其標題前加上 WIP:
或 [WIP]
(不區分大小寫)。
這些值可以在您的 app.ini
文件中配置:
[repository.pull-request]
WORK_IN_PROGRESS_PREFIXES=WIP:,[WIP]
列表中的第一個值將用於幫助程序。
拉取請求模板
您可以在 問題和拉取請求模板 頁面找到有關拉取請求模板的更多信息。