如何在 GitHub 上提交 PR (Pull Request)

如何在 GitHub 上提交 PR (Pull Request)

本文将带你从 Fork 仓库到创建分支、提交改动、发起 PR、再到删除分支的完整流程。你可以直接下载此文件并复制到你的博客中。

---

1. Fork 仓库

1. 打开原作者的仓库页面，例如：

   https://github.com/username/app1
   

2. 点击右上角 Fork，将仓库复制到你的个人账号下。
3. 你的 Fork 地址形如：

   https://github.com/myname/app1
   

---

2. 保持主分支干净

• Fork 完成后，你的仓库会有一个默认分支（通常为 master 或 main）。
• 切勿直接在该分支上开发，始终保留它用于同步上游最新代码。

---

3. 新建功能/修复分支

1. 在你的 Fork 仓库页面，点击左上角分支下拉框（显示 main 或 master）。
2. 在输入框中输入新分支名，例如：

   feat/localization-zh_CN
   

3. 按 Enter 即可创建并切换到该分支。

---

4. 在分支上开发并提交

• 网页端：
  • 点击 Add file > Create new file 添加或编辑文件。
  • 点击铅笔图标（✎）在线修改已有文件。
• 本地端：

  git checkout master
  git pull upstream master        # 同步上游
  git checkout -b feat/localization-zh_CN
  # 添加或修改文件后：
  git add localizations/zh_CN.json index.json
  git commit -m "feat(i18n): add Simplified Chinese localization (zh_CN)"
  git push origin feat/localization-zh_CN
  

提交信息规范

• 使用 Conventional Commits：
  • feat(i18n): add Simplified Chinese localization (zh_CN)
  • fix(cli): correct typo in help message

---

5. 发起 Pull Request

1. 在 GitHub 页面上，点击黄色横幅 Compare & pull request；或进入 Pull requests > New pull request。
2. Base repository 选择原作者仓库，base branch 选择 master（或指定的开发分支）；
   Head repository 选择你的 Fork 分支 feat/localization-zh_CN。
3. 填写 PR 标题和描述，例如：

   feat(i18n): add Simplified Chinese (zh_CN) localization
   

4. 点击 Create pull request。

---

6. 合并后删除分支

• 等待维护者审核并合并后，可在 PR 页面点击 Delete branch；
• 或者在本地和远程执行：

  git checkout master
  git pull upstream master
  git push origin master
  git branch -d feat/localization-zh_CN
  git push origin --delete feat/localization-zh_CN
  

---

7. 下次贡献再循环

1. 从 master 同步最新：

   git checkout master
   git pull upstream master
   git push origin master
   

2. 新建分支、开发、PR、删除分支。

这样你的 Fork 仓库始终保持干净，只需一次 Fork，分支按需增删，管理轻松有序。