GitHub 是一个面向开源及私有项目的托管平台,因为只支持 Git 作为唯一的版本库格式进行托管,故名 GitHub。GitHub 于 2008 年 4 月 10 日正式上线,除了 Git 代码仓库托管及基本的 Web 管理界面以外,还提供了订阅、讨论组、文本渲染、在线文件编辑器、协作图谱(报表)、代码片段分享(Gist)等功能。
Github 最近新发布了一个神器 GitHub CLI
,简称 gh,gh 可以理解为命令行版的 GitHub,开发人员无需在浏览器上操作 GitHub ,通过终端执行指令,它可以实现创建 issues,切分支、发布版本,mgered、 Pull 、push 等。减少了浏览器和终端的切换,可以让开发者更轻松创建工作流程,命令行是程序员最原始的快感。
01.下载安装
通过登录网站: https://github.com/cli/cli/releases 选择对应系统的安装包进行安装,支持Windows、Mac、Linux等系统。
使用之前需要先登录认证,在终端中执行命令 gh auth login ,会出现交互式的命令
出现上面的 Logged in as xxx 即为登录认证成功。
例如一个你和多个开发者共同开发一个项目,用到的工作流程可能会有 Issues 的查看、发起 pull request 、代码提交内容查看、代码review和远程分支请求合并。下面让小编结合一些实际的使用场景,列举 gh 常用的指令吧。
02.使用 gh 克隆项目代码
从下图中可以看到 Clone 选项卡有三个选择,在原来的基础上多了GitHbub CLI选项。
执行 gh repo clone 项目名称,就会把自己的 github 上的项目克隆到本地
克隆项目成功后,切换到项目的工作目录,就可以执行一些 gh 命令了。
03.查看 issues
执行 gh issue list 可以查看当前项目中的 issue 列表信息
执行 gh issue status ,可以查看有没有分配给你的 issues 、与你有关的issues以及你填写的 issues 。无需打开浏览器查看,直接在终端执行对应的命令即可。
04.创建新的 pull request
开发完某个版本的功能后,除了将本地代码 push 到远程仓库,还需要发起 pull request 。pull request 可以理解为,我改了你们的代码,你们拉回去看看吧!通过在终端执行 gh pr create 即可创建新的拉取请求,也可以自定义 Title 和 Body 的内容,也可以按 Enter 健跳过内容编辑。
通过浏览器进行检查,可以看到新的 pull request
05.查看 pull request 的改动
执行 gh pr diff 命令可以查看项目其他成员提交的变动内容,如下图
06.代码 review
作为项目负责人,需要审核其他开发人员提交的 pull request,执行 gh pr review 可以批准 pull request 。
07.代码合并
批准 pull request 后就可以进行远程仓库分支的合并了,执行 gh pr merge 即可创建一个合并分支的请求,并且提供了合并成功之后可以在本地删除分支的功能。
以上是 gh 几个简单的使用案例,它还能实现更强大的功能,如果你也想试试,不妨去看看官方手册吧,一定会让你管理 GitHub 事半功倍。