【GitHub】如何在github上提交PR(Pull Request

  • 写在最前面
  • 1. 准备工作
  • 1.1 注册 GitHub 账号
  • 1.2 了解 Git 基础
  • 1.3 找到一个项目
  • 2. 创建你的 PR
  • 2.1 Fork 和克隆仓库
  • 2.2 创建一个新的分支
  • 2.3 进行更改
  • 2.4 推送更改到 GitHub
  • 2.5 创建 Pull Request
  • 3. 优化你的 PR
  • 3.1 保持提交清晰
  • 3.2 遵守项目约定
  • 3.3 沟通
  • 3.4 测试
  • 4. 如何提交多个PR
  • git代码版本
  • 页面操作版本
  • 小结



【GitHub】如何在github上提交PR(Pull Request) + 多个pr同时提交、互不干扰_PR


🌈你好呀!我是 是Yu欸

🌌 2024每日百字篆刻时光,感谢你的陪伴与支持 ~ 🚀 欢迎一起踏上探险之旅,挖掘无限可能,共同成长!


写在最前面

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 合入上游项目。

【GitHub】如何在github上提交PR(Pull Request) + 多个pr同时提交、互不干扰_github_02

使用以下命令克隆仓库:

git clone https://github.com/your-username/repository-name.git
cd repository-name
2.2 创建一个新的分支

在你的本地仓库中创建一个新分支进行工作,这是一个好习惯。你可以使用以下命令创建并切换到一个新分支:

git checkout -b feature-branch-name
2.3 进行更改

在新分支中,进行你想要的更改。这可能是添加新功能、修复错误或改进文档。完成更改后,使用 git addgit 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”按钮。点击它,选择你的新分支和原始仓库的目标分支(通常是 mainmaster),填写 PR 的标题和描述,解释你的更改和为什么应该接受这些更改。

【GitHub】如何在github上提交PR(Pull Request) + 多个pr同时提交、互不干扰_PR_03

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请求。

【GitHub】如何在github上提交PR(Pull Request) + 多个pr同时提交、互不干扰_github_04


然后提交新pr就行

【GitHub】如何在github上提交PR(Pull Request) + 多个pr同时提交、互不干扰_git_05

小结

提交 PR 是开源社区中的一种重要的参与方式,它不仅可以帮助你提高编程技能,还可以扩展你的技术网络。通过遵循上述步骤和建议,你将能够更有效地在 GitHub 上贡献代码。记住,每个贡献都是向开源社区学习和回馈的机会,每次提交都有可能影响成千上万的开发者和最终用户。