如何在 GitHub 中创建拉取请求

学习如何 fork 代码仓库,进行更改,并请求维护者审查和合并。
250 位读者喜欢这篇文章。
a checklist for a team

Opensource.com

所以,你了解如何使用 git。你有一个 GitHub 代码仓库,并且可以推送代码。一切都很好。但是,你究竟如何为别人的 GitHub 项目做贡献呢? 这就是我在学习 git 和 GitHub 之后想要了解的。在本文中,我将解释如何 fork 一个 git 代码仓库,进行更改,并提交拉取请求。

当你想参与 GitHub 项目时,第一步是 fork 代码仓库。

Forking a GitHub repo

使用我的演示代码仓库来尝试一下。

到达那里后,点击右上角的 Fork 按钮。这将在你的 GitHub 用户账户下创建我的演示代码仓库的一个新副本,URL 类似于

https://github.com/<YourUserName>/demo

这个副本包含来自原始代码仓库的所有代码、分支和提交。

接下来,通过在你的计算机上打开终端并运行以下命令来克隆代码仓库

git clone https://github.com/<YourUserName>/demo

一旦代码仓库被克隆,你需要做两件事

  1. 通过发出以下命令创建一个新分支

    git checkout -b new_branch
  2. 使用以下命令为上游代码仓库创建一个新的 remote

    git remote add upstream https://github.com/kedark3/demo

在本例中,“上游代码仓库”指的是你从中 fork 的原始代码仓库。

现在你可以对代码进行更改。以下代码创建一个新分支,进行任意更改,并将其推送到 new_branch

$ git checkout -b new_branch
Switched to a new branch ‘new_branch’
$ echo “some test file” > test
$ cat test
Some test file
$ git status
On branch new_branch
No commits yet
Untracked files:
  (use "git add <file>..." to include in what will be committed)
    test
nothing added to commit but untracked files present (use "git add" to track) 
$ git add test
$ git commit -S -m "Adding a test file to new_branch"
[new_branch (root-commit) 4265ec8] Adding a test file to new_branch
 1 file changed, 1 insertion(+)
 create mode 100644 test
$ git push -u origin new_branch
Enumerating objects: 3, done.
Counting objects: 100% (3/3), done.
Writing objects: 100% (3/3), 918 bytes | 918.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
Remote: Create a pull request for ‘new_branch’ on GitHub by visiting:
Remote:   http://github.com/example/Demo/pull/new/new_branch
Remote: 
 * [new branch]  	new_branch -> new_branch

一旦你将更改推送到你的代码仓库,比较 & 拉取请求 按钮将出现在 GitHub 中。

GitHub's Compare &amp; Pull Request button

opensource.com

点击它,你将被带到此屏幕

GitHub's Open pull request button

通过点击 创建拉取请求 按钮来打开一个拉取请求。这允许代码仓库的维护者审查你的贡献。从这里,如果你的贡献良好,他们可以合并它,或者他们可能会要求你进行一些更改。

TLDR(太长不看)

总而言之,如果你想为一个项目做贡献,最简单的方法是

  1. 找到你想贡献的项目
  2. Fork 它
  3. 克隆到你的本地系统
  4. 创建一个新分支
  5. 进行你的更改
  6. 将其推送回你的代码仓库
  7. 点击 比较 & 拉取请求 按钮
  8. 点击 创建拉取请求 以打开一个新的拉取请求

如果审查者要求更改,请重复步骤 5 和 6 以向你的拉取请求添加更多提交。

祝你编程愉快!

接下来阅读什么
标签
User profile image.
Kedar 是 Red Hat 的一名软件质量工程师,负责 CloudForms(上游 ManageIQ)项目,主要关注我们内部基础设施的部署/管理。对 Jenkins Pipeline 和 Ansible 用于自动化部署很感兴趣。也在编写用于监控和警报的 Shinken 模块。

5 条评论

哇,非常感谢您与我们分享这篇内容丰富的文章!我真的很喜欢您的这篇文章。

关于 git 的术语,有很多我难以理解的地方。
“为上游代码仓库创建一个新的 remote”。remote-什么?remote 是一个形容词。“上游代码仓库”——指的是什么?
我仍然不明白“拉取请求”这个术语从何而来,以及它到底意味着什么。这些事情可以用人类容易理解的语言来解释吗?

嗨,Greg,我写过更多关于 Git 的文章,你可能会觉得有帮助。 https://open-source.net.cn/user_articles/131551/131551

此外,之所以称为拉取请求,是因为当你想让你的代码合并到别人的项目中时,你需要请求他们“拉取”它。因此它被称为拉取请求。:) 上游代码仓库通常是别人拥有的代码仓库,你想为它做贡献。
最后,Remote 只是一个术语,用于表示你与之交互的 URL 的名称。如果你克隆了一个 git 代码仓库,你可以运行

git remote -v

你将看到所有 remotes,默认情况下通常称为“Origin”。当你运行类似以下的命令时

git push origin xyz
git pull origin xyz

那个 origin 会被替换为实际的 URL,以便 git 知道将代码推送到哪里。

希望对您有所帮助。

回复 ,评论者:Greg P

非常有帮助的文章。非常感谢!

Creative Commons License本作品根据知识共享署名-相同方式共享 4.0 国际许可协议获得许可。
© . All rights reserved.