GitHub-Cli 的安装与使用

Take GitHub to the command line!

GitHub-Cli

想必 GitHub 大家都不陌生。一开始我也只是偶尔上去安装个软件啥的，但是自从几个月前我接触到用 GitHub 作为服务器和二级域名来做网站后，我访问 GitHub 也就更加频繁了。每天都要重复登陆、收验证码实在是有些浪费时间了，再加上这么慢的网速，于是我开始使用 Git+Hexo 本地生成 + 上传的模式。可用了一段时间后，我却发现有比 Git 更快、更强、更高大上的终端命令行 ——GitHub-Cli(以下也简称 gh)。

一.Gh 简介

GitHub-Cli, 也就是 GitHub最新推出的命令行终端，具有快速、高效等特性，给万千码农带来了极大的福利 —— 更快地访问、克隆仓库，更快的提交更新，更高效的处理 issue 和 PR。 曾经必须要到 GitHub 网页端才能修改的元信息，现在在 CMD 上就可以操作。
十几天前 gh 已经推出了最新的 2.4.0 版本。这款终端使用 GoLang 编写，配合一定的批处理文件就可以完成一切任务。最新数据显示该仓库已经有了 2 万 6 千个 Star。
项目官网 项目源码地址

二.Gh 的安装

安装其实很简单，毕竟它不是 GUI，只是一个类似 Bash 的东东嘛。下面以 Windows 为例：

1. 安装包安装（通用）

访问这个链接，找到 Assets。然后你会找到很多很多的安装包，在比较下面的地方有一个 gh_2.4.0_windows_amd64.msi 的安装文件（貌似是 64 位的）。尝试下载它……
下载下来以后，直接运行安装即可。安装完成后，打开 CMD 运行：

$ gh --version  

如果 CMD 返回给你有用的信息（而不是 “gh“不是内部或外部命令，也不是可运行的程序或批处理文件。），那么说明你已经安装好了！

2. Chocolatey 安装

使用过 Chocolatey 的同志直接运行下面的命令！

$ clist gh
$ choco install gh

嗯…… 搞定了！

三. Gh 登录时刻！

准备好你的 GitHub 账号，我们终于要登录了！登录也很简单，只要运行：

$ gh auth login  //这很简单吧！

然后就会有下面的提示语：

Auth_Login

图片来源于网络…… 所以不是我的用户名
两种登陆方法：你可以使用浏览器登陆账号后登录 GitHub-Cli，也可以使用粘贴个人验证码登录。由于 GitHub-Cli 的内核也是用到 Git 的，所以它也会要求你配置 Git，选择 SSH 或者 HTTPS 貌似都差不多。
如果最后它提示你类似 Logged in as … 说明你成功了！！

四。关于你的仓库

使用 “项目托管平台” 你没有仓库怎么行？用你本地的 Git 或者在线创建一个仓库，然后你就可以操作了。

New_Repo

创建一个仓库后，把它拉取到本地。这个时候 GitHub-Cli 就能派上用场了：

$ gh repo clone {username}/{repo_name}

现在你的电脑上应该就有了一个本地仓库。现在让我们来更新它！
首先我们来切换到一个新的分支（Git 版本库中存放项目不同版本的一种机制） 。然后，做一点点修改，然后再提交回远程端 （在这里就是 GitHub！）：

$ git checkout –b test  //checkout -b 会创建并进入一个新的分支
$ mkdir Test12.17  //创建一个文件夹
$ cd Test12.17
$ echo “What makes unicorns cry?”>>test.txt  //做一点点修改

现在我们已经生成了一个新文件夹，一个新文件并进入了一个新的分支。然后，用大家都熟知的 Git 来进行以下操作：

$ git add .  //缓存所有修改
$ git commit –m “Update 12.17”  //创建一个更新记录
$ git push –-set-upstream origin test  //上传 注意这里需要配置远程

现在貌似我们的更改已经被上传到 GitHub 上面去了！不过很明显，我们提交到的是一个叫做 test 的分支，我们还需要把他提交到 master，即主分支上去。

五.PRs

其实我们的确可以将更新直接提交到 master 上，但这不是重点 —— 在 GitHub 上更多的是多人合作项目，这时将更新代码直接提交到主分支上貌似就有点风险了 （万一有 Bug 呢） 。然后，我们就可以尝试一种新的方式 ——Pull Request。（感觉前面铺垫好多）
Pull Request 是一种通知机制。你修改了他人的代码，将你的修改通知原来的作者，希望他合并你的修改，这就是 Pull Request。Pull Request 本质上是一种软件的合作方式，是将涉及不同功能的代码，纳入主干的一种流程。这个过程中，还可以进行讨论、审核和修改代码。
所以，你学废了吗……

1. 创建 PR

现在我们来尝试创建一个新 PR。当然，我们是个人项目，所以 PR 仅起到演示的效果。
如图所示，创建一个 PR 我们需要运行：

$ gh pr create  //等同于 $ gh pr cr

同时我们会需要提供例如标题、基本信息等等等等。当输出类似以下的提示时，你就成功了。

https://github.com/Guleixibian2009/test/pull/1

PR_Create

2.PR 的合并

很明显，单独创建一个 PR 是没有用的。我们需要把他合并到主分支里！首先我们看一下到底有没有这个 PR：

$ gh pr list

这个命令可以帮助我们查看所有的 PR。比如下面的仓库就有 2 个进行中的 PR:

PR_List

Em…… 只需要注意最上面那一行命令就可以了，后面两条是添加了几个限定条件。（看起来好复杂）
很明显我们的确有进行中的 PR。为了将其合并入主分支，我们来 Merge 刚刚那个 PR。

示意图如下：

PR_Merge

当然在合并 PR 时我们会需要选择一些基本信息，一般情况下选择 Create a merge commit。如果你不想删除这个 test 分支，你可以在第二个选项中选择 No。最后它会有提示语：

Merged pull request #1

然后，我们怎么知道自己的 PR 真的真的已经被合并了呢？我们可以切换回原分支 master。

$ git checkout master  //不需要 -b ，因为不是新分支
$ gh repo sync  //这个指令可以同步当前分支

如果你的 master 分支中多了一开始创建的文件，那么，这个 PR 就是真的被合并了。
最后，如果你还想了解 GitHub-Cli 更多有关命令，你可以运行：

$ gh <command> <subcommand> --help
  //此处 <command>/<subcommand> 要用具体的命令代替
  //如： gh repo clone --help

就可以获得有关命令的更多信息了！

六。写在最后

经过我的一通讲解，相信大家已经掌握了 GitHub-Cli 的一些基本操作，如登录，同步仓库，等等，并且 “深入” 了解了 Pull Request。在此希望 GitHub-Cli 可以和广大码农一同进步，一同成长！我们下期再见～～～

---

THE END 感谢您的阅读～