拉取请求
拉取请求 (PR) 是提出对仓库进行更改的一种方式。它是一个将一个分支合并到另一个分支的请求,并附带对所做更改的描述。拉取请求通常用作贡献者提出更改以及维护者审查和合并这些更改的方式。
创建拉取请求
要创建 PR,您需要按照以下步骤操作
-
派生仓库 - 如果您没有直接更改仓库的权限,您需要将仓库派生到自己的帐户。这将创建您可以更改的仓库副本。
-
创建分支(可选) - 在派生的仓库上创建一个新分支,该分支包含您要提出的更改。为分支命名一个描述性的名称,表明更改是为了什么。
-
进行更改 - 进行所需的更改,提交并将其推送到您的派生仓库。
-
创建 PR - 转到原始仓库,然后转到“拉取请求”选项卡。单击“新建拉取请求”按钮,然后选择您的新分支作为源分支。为拉取请求输入一个描述性的标题和描述,然后单击“创建拉取请求”。
审查拉取请求
创建 PR 时,会触发审查流程。仓库的维护者会收到 PR 的通知,并可以审查所做的更改。他们可以发表评论、要求更改或批准更改。
如果维护者要求更改,您需要在您的分支中进行这些更改,并将更改推送到您的派生仓库。PR 将自动使用新更改更新。
如果维护者批准更改,他们可以将 PR 合并到仓库中。
关闭拉取请求
如果您决定不再要合并 PR,您可以将其关闭。要关闭 PR,请转到打开的 PR 并单击“关闭拉取请求”按钮。这将关闭 PR,不会将其合并。
“正在进行”拉取请求
将拉取请求标记为正在进行将阻止该拉取请求被意外合并。要将拉取请求标记为正在进行,您必须在标题前缀为WIP:
或 [WIP]
(不区分大小写)。这些值可以在您的 app.ini
文件中配置。
[repository.pull-request]
WORK_IN_PROGRESS_PREFIXES=WIP:,[WIP]
列表中的第一个值将在助手程序中使用。
拉取请求模板
您可以在页面 问题和拉取请求模板 中找到有关拉取请求模板的更多信息。