我要评论
【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
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 上贡献代码。记住，每个贡献都是向开源社区学习和回馈的机会，每次提交都有可能影响成千上万的开发者和最终用户。
欢迎大家添加好友，持续发放粉丝福利！
发表评论