GitHub CLI 上手:登录配置、常用命令与 PR 工作流提效

适合谁用:把 GitHub 常用操作放进命令行

如果你经常在 GitHub 上做这些事:克隆仓库、看 Issue、处理 Pull Request、查 CI 状态、创建 Release,那么 GitHub CLI(gh) 会非常省时间:不用频繁切回浏览器,终端里就能把流程走完。

工具主页:https://cli.github.com/(官方)

安装:Windows / macOS / Linux 三种常见方式

Windows(winget)

winget install --id GitHub.cli

macOS(Homebrew)

brew install gh

Ubuntu / Debian(apt)

sudo apt update

sudo apt install gh

安装完成后先确认版本:

gh --version

首次登录与权限选择:建议用浏览器授权,省掉手动填 Token

最稳妥的方式是让 gh 打开浏览器完成授权(支持 HTTPS 或 SSH 两种 Git 传输方式)。

gh auth login

登录后检查当前账号与授权状态:

gh auth status

如果你在多台机器/多账号之间切换,可以列出与切换身份:

gh auth status --show-token

gh auth switch

参考文档:https://docs.github.com/en/github-cli/github-cli/authenticating-to-github

高频命令速查:克隆、Issue、PR、CI 状态一把梭

1) 克隆仓库(含 fork 场景)

gh repo clone OWNER/REPO

gh repo fork OWNER/REPO --clone

2) Issue 列表与创建

gh issue list

gh issue create

3) PR 创建、查看与本地检出

gh pr create

gh pr view --web

gh pr checkout 123

4) 快速看 CI / Checks

gh run list

gh run view --log

用 alias 做“个人快捷键”:把常用命令压缩成 2~3 个字母

你可以把长命令设置成别名,团队也能共享同一套习惯(写进文档或 onboarding 清单)。例如:

gh alias set co "pr checkout"

gh alias set pv "pr view"

gh alias set il "issue list"

查看当前别名:

gh alias list

常见坑位与排查:遇到权限/网络/SSH 问题先看这里

1) 没权限推送 / PR 操作失败:优先检查登录状态与授权范围。

gh auth status

2) 公司网络代理 / 证书问题:建议先确认系统代理设置是否对终端生效;必要时按公司 IT 规范配置环境变量。

3) HTTPS 与 SSH 混用导致拉取异常:统一仓库 remote(尤其是多机器同步时)。

git remote -v

一个推荐的“最小工作流”:每天用到的 5 步

如果你不想一下子记很多命令,可以从下面这套开始:

gh auth login(只需第一次)

gh repo clone ...

gh issue list

gh pr create

gh run list

补充参考:项目源码与更新日志 https://github.com/cli/cli

用户评论 (0)

登录后参与讨论

立即登录 注册账号

暂无评论,快来抢沙发吧~

操作成功