【GitHub】如何在github上提交PR(Pull Request
写在最前面
GitHub 是全球最大的代码托管平台之一,允许开发者共享代码、协作开发,并进行版本控制。在这个平台上,Pull Request(简称 PR)是一个非常关键的功能,允许你向其他项目贡献代码。这篇博客将详尽介绍如何在 GitHub 上成功提交 PR,包括准备工作、创建 PR 的步骤,以及如何优化你的 PR 以增加被接受的可能性。
参考:如何参与开源项目 - 细说 GitHub 上的 PR 全过程
1. 准备工作
1.1 注册 GitHub 账号
如果你还没有 GitHub 账号,你需要先注册一个。访问 GitHub 官网,点击右上角的“Sign up”按钮,按照提示完成注册流程。
1.2 了解 Git 基础
在尝试提交 PR 前,你需要具备基本的 Git 知识。Git 是一个分布式版本控制系统,广泛用于软件开发中跟踪代码更改。如果你不熟悉 Git,建议先学习以下基础命令:
git clone
: 克隆一个远程仓库到本地git branch
: 管理分支git checkout
: 切换分支git add
: 添加文件到暂存区git commit
: 提交更改git push
: 将本地更改推送到远程仓库
1.3 找到一个项目
在 GitHub 上,找到一个你感兴趣的开源项目,通常你可以通过项目的 README 文件了解如何贡献代码。确保你阅读了项目的贡献指南(CONTRIBUTING.md),这对于接下来的步骤非常重要。
2. 创建你的 PR
2.1 Fork 和克隆仓库
首先,你需要将项目仓库“Fork”到你的账户下。这可以通过点击项目主页上的“Fork”按钮来完成。Fork 完成后,你将拥有该仓库的副本(副本将出现在你自己账号的仓库里面)。
然后回到自己账号下,可以找到 fork 到的项目了,接着你需要将其克隆到本地进行修改。
这个项目在你自己的账号下,也就意味着你有任意修改的权限了。我们后面要做的事情,就是将代码变更提到自己 fork 出来的代码库里,然后再通过 Pull Request 的方式将 commits 合入上游项目。
使用以下命令克隆仓库:
git clone https://github.com/your-username/repository-name.git cd repository-name
2.2 创建一个新的分支
在你的本地仓库中创建一个新分支进行工作,这是一个好习惯。你可以使用以下命令创建并切换到一个新分支:
git checkout -b feature-branch-name
2.3 进行更改
在新分支中,进行你想要的更改。这可能是添加新功能、修复错误或改进文档。完成更改后,使用 git add
和 git commit
命令提交这些更改。
git add . git commit -m "Add a descriptive commit message"
2.4 推送更改到 GitHub
将你的更改推送到你的 GitHub 仓库:
git push origin feature-branch-name
2.5 创建 Pull Request
回到 GitHub,在你的仓库页面上,你会看到一个“Compare & pull request”按钮。点击它,选择你的新分支和原始仓库的目标分支(通常是 main
或 master
),填写 PR 的标题和描述,解释你的更改和为什么应该接受这些更改。
3. 优化你的 PR
3.1 保持提交清晰
确保每个提交都紧密相关,并且提交信息清晰明了。这会使项目维护者更容易理解你的更改,并加快 PR 的审查过程。
3.2 遵守项目约定
遵守项目的编码规范和命名约定。这不仅
展示了你对项目的尊重,也减少了因风格不一致导致的额外修改。
3.3 沟通
PR 的过程中,维护者可能会有反馈或要求你进行更改。保持开放的态度,积极响应反馈,并按需修改你的 PR。
3.4 测试
在提交 PR 之前,确保你的更改没有引入任何错误。运行项目中的测试,并尽可能添加你自己的测试,以验证功能。
4. 如何提交多个PR
注意:同一个项目只能fork一次,所以可以在fork的本地仓库下,创建多个新的分支
git代码版本
创建新分支:为每个pull请求创建一个新分支。在命令行中使用以下命令创建并切换到一个新分支:
$ git checkout -b new-branch
进行修改:在新分支上进行任何需要的修改或添加新功能。
提交变更:使用以下命令将修改提交到你fork的仓库中:
$ git add . $ git commit -m "Your commit message" $ git push origin new-branch
页面操作版本
发起pull请求:在GitHub上,导航到你fork的仓库页面。点击”New pull request”按钮,选择你的分支和主仓库的分支,填写描述信息,并提交pull请求。
然后提交新pr就行
小结
提交 PR 是开源社区中的一种重要的参与方式,它不仅可以帮助你提高编程技能,还可以扩展你的技术网络。通过遵循上述步骤和建议,你将能够更有效地在 GitHub 上贡献代码。记住,每个贡献都是向开源社区学习和回馈的机会,每次提交都有可能影响成千上万的开发者和最终用户。
欢迎大家添加好友,持续发放粉丝福利!