{"meta":{"title":"拉取请求快速入门","intro":"提出你的第一个更改，并将其从首次提交一路推进到拉取请求被合并。","product":"拉取请求","breadcrumbs":[{"href":"/zh/pull-requests","title":"拉取请求"},{"href":"/zh/pull-requests/get-started","title":"开始"},{"href":"/zh/pull-requests/get-started/pull-request-quickstart","title":"拉取请求快速入门"}],"documentType":"article"},"body":"# 拉取请求快速入门\n\n提出你的第一个更改，并将其从首次提交一路推进到拉取请求被合并。\n\n拉取请求建议在独立于主代码库的分支上进行更改，以便其他人可以在合并更改之前查看这些更改。 本快速入门将指导你通过最简单的方法创建拉取请求。 你将创建分支、进行和提交更改、打开拉取请求、响应反馈和合并。\n\n选择上方的其中一个选项卡，即可在 GitHub 网站上或通过 GitHub CLI 跟着操作。\n\n## 为该仓库创建分支或派生副本\n\n首先创建一个隔离的工作环境。\n\n\n\n1. 在 GitHub上，导航到要为其建议更改的存储库的主页。\n2. 或者，如果你没有写权限，就需要创建一个 fork。 单击右上角的 **Fork**，然后按照步骤操作。 然后，在存储库的分支中继续操作。\n3. 单击文件列表顶部的分支选择器菜单。 它上面可能写着 **main**。 键入新的分支名称，然后单击 **“从 main 创建分支 *new-branch-name***”。\n\n
\n\n \n\n1. 若要使用 GitHub CLI，首先需要安装它。 请参阅“[GitHub CLI 快速入门](/zh/github-cli/github-cli/quickstart)”。\n\n2. 克隆存储库。 或者，将存储库分叉并同时在本地克隆。\n\n* 如果对存储库具有写入访问权限，请克隆存储库：\n\n ```shell\n gh repo clone OWNER/REPO\n ```\n\n* 如果你没有写入权限，你需要先创建一个 **派生**，然后一次性将其克隆下来。\n\n ```shell\n gh repo fork OWNER/REPO --clone\n ```\n\n1. 切换到克隆的仓库目录。\n\n ```shell\n cd REPO\n ```\n\n2. 创建并切换到新分支。\n\n ```shell\n git checkout -b YOUR-BRANCH-NAME\n ```\n\n
\n\n## 创作或编辑代码\n\n请在该分支中进行修改。 对于你的第一个拉取请求，请确保改动聚焦且简洁。 较小的拉取请求审查起来更快，也更容易合并。\n\n请尝试以下其中一项进行更改：\n\n* 在本地 IDE 或文本编辑器中编辑文件。\n* 只需浏览到该文件并点击GitHub，即可直接在上编辑文件。\n\n## 频繁提交\n\n将工作保存在小型有意义的提交中。 每次提交都会记录一个快照和一条描述此次更改的消息。\n\n\n\n```shell\ngit add .\ngit commit -m \"Describe your change\"\ngit push --set-upstream origin YOUR-BRANCH-NAME\n```\n\n
\n\n\n\n当你在 GitHub 上编辑文件并准备好提交时，输入提交说明，然后直接提交到你的分支。\n\n1. 单击“ **提交更改...”**。\n2. 在 **“提交”消息** 框中，输入所做更改的简短说明。\n3. 选择要处理的分支。\n4. 单击“提议更改”。\n\n你的更改将被添加并提交到该分支。\n\n
\n\n## 打开拉取请求\n\n当你的分支中包含了你想提出的更改时，向基础分支发起拉取请求。\n\n\n\n\n\n你可以创建可供审查的拉取请求，也可以创建草稿状态的拉取请求。\n\n* 如果已准备好供审核：\n\n ```shell\n gh pr create\n ```\n\n* 共享正在进行的工作\n\n ```shell\n gh pr create --draft\n ```\n\n然后，按照提示设置基本分支、标题和说明。\n\n
\n\n如果对同一分支进行进一步提交，它们将自动添加到拉取请求中。\n\n## 请求评审\n\n若要通过 **“审阅者** ”框请求评审，需要对存储库具有写入访问权限，并且可以请求具有对存储库的读取访问权限的人员或团队的评审。 如果你请求审查，相关人员或团队将收到通知。 在某些情况下，你会看到系统建议的审阅者，你可以从中选择。\n\n如果“**审阅者**”框不可用，您可以：\n\n* 查看存储库的自述文件，获取有关拉取请求评审的指导，并按照其说明进行操作。\n* 如果你知道谁可以帮你进行评审，请联系对方，并将你的拉取请求链接发给对方。\n\n## 处理评审反馈\n\n审阅者可以在合并拉取请求之前注释、建议更改或请求更改。\n\n* 若要接受审阅者的建议，请单击 **“提交建议** ”（或批量单击“ **提交”建议**）。\n* 若要进行更广泛的更改，请编辑代码并将新提交推送到同一分支。 拉取请求会自动更新，并重新运行所有检查项。\n* 处理完后，将每个对话都标记为 **已解决**。\n\n## 合并和部署\n\n所需评审和状态检查均通过后，合并拉取请求，将你的更改合并到基础分支。 如果决定不合并更改，可以改为关闭拉取请求。\n\n> \\[!TIP]\n> 不同的存储库可能有不同的合并要求。 查看任何相关指南并按照其说明进行操作。\n\n\n\n1. 在拉取请求的底部，单击“ **合并拉取请求**”。\n2. 单击“ **确认** ”以完成合并。\n3. （可选）删除头分支以保持存储库整洁。\n\n
\n\n\n\n```shell\ngh pr merge\n```\n\n按照提示选取合并方法并选择性地删除分支。\n\n
\n\n## 后续步骤\n\n在你提交第一个拉取请求后，试着审核一下别人的工作。 请参阅“[关于查看拉取请求的快速入门](/zh/pull-requests/get-started/reviewing-pull-requests-quickstart)”。\n\n## 延伸阅读\n\n* [为项目编写代码](/zh/pull-requests/concepts/writing-code-for-a-project)\n* [拉取请求](/zh/pull-requests/reference/pull-requests)"}