Pull Request 的命令行管理

来源于互联网 作者： 阮一峰

 

Github 的一大特色就是 Pull Request 功能（简写为 PR）。

对于多人合作的项目，该功能简直必不可少。大部分人都是使用 Web 界面（如上图），本文介绍如何在命令行下处理 PR，翻译自 Cédric Beust 的文章。

一、Pull Request 是什么？

Github 官方文档的定义如下。

"Pull Request 是一种通知机制。你修改了他人的代码，将你的修改通知原来的作者，希望他合并你的修改，这就是 Pull Request。"

Pull Request 本质上是一种软件的合作方式，是将涉及不同功能的代码，纳入主干的一种流程。这个过程中，还可以进行讨论、审核和修改代码。

二、Pull Request 的流程

第一步，你需要把别人的代码，克隆到你自己的仓库，Github 的术语叫做 fork。

第二步，在你仓库的修改后的分支上，按下"New pull request"按钮。

这时，会进入一个新页面，有Base 和 Head 两个选项。Base 是你希望提交变更的目标，Head 是目前包含你的变更的那个分支或仓库。

第三步，填写说明，帮助别人理解你的提交，然后按下"create pull request"按钮即可。

PR 创建后，管理者就要决定是否接受该 PR。对于非代码变更（比如文档），单单使用 Web 界面就足够了。但是，对于代码变更，Web 界面可能不够用，需要命令行验证是否可以运行。

三、git am

git am命令用于将一个 patch 文件，合并进入当前代码。

Github 对每个 PR 会自动生成一个 patch 文件。我们下载该文件，合并进本地代码，就可以在本地查看效果了。

$ curl -L http://github.com/cbeust/testng/pull/17.patch | git am

上面代码中，curl的-L参数表示，如果有302跳转，curl会自动跟进。后面网址里面的/cbeust/testng是目标仓库，pull/17表示该仓库收到的第17个 PR。

如果 PR 只包含一个 commit，那么也可以直接下载这个 commit 的 patch 文件。

$ curl https://github.com/sclasen/jcommander/commit/bd770141029f49bcfa2e0d6e6e6282b531e69179.patch | git am

上面代码中，网址里面的/sclasen/jcommander是代码变更所在的那个仓库。

四、创建远程仓库

另一种方法是为 PR 创建一个远程分支，追踪提交者的仓库。

# 创建远程仓库，指向 PR 提交者的仓库
$ git remote add nullin git://github.com/nullin/testng.git

# 从该远程仓库拉取代码
$ git fetch nullin

# 将该仓库的某个分支合并到当前分支
$ git merge kneath/error-page

# 推送到自己的仓库
$ git push origin master

五、cherry-pick

有时，PR 里面包含好几个 commit，但是你只想合并其中的一个或几个。

这时可以使用cherry-pick命令，挑出你感兴趣的 commit。

# 建立远程分支，追踪提交者的仓库
$ git remote add nullin git://github.com/nullin/testng.git

# 从该远程仓库拉取代码
$ git fetch nullin

# 只将感兴趣的 commit 加入当前代码
$ git cherry-pick commit1
$ git cherry-pick commit2

# 推送到自己的仓库
$ git push origin master

（完）