如果你经常在 GitHub 上处理仓库、Issue、Pull Request(PR)或 Actions,那么 GitHub CLI(命令为 gh)可以把一大堆“点来点去”的步骤收敛成可复制、可脚本化的命令,尤其适合:频繁开/看 PR、批量拉取仓库、查询 CI 状态、在终端里快速定位问题的人。
参考链接:https://docs.github.com/en/github-cli
macOS(Homebrew)
brew install gh
Windows(WinGet)
winget install --id GitHub.cli
Ubuntu/Debian(apt,示例)
不同发行版的安装方式略有差异,推荐直接按官方说明选择对应包管理器;如果你用的是 apt 系,常见做法是先配置 GitHub 的软件源再安装。
首次使用建议先登录:
gh auth login
一般选择 GitHub.com,再选择使用浏览器登录(更省事)。登录完成后可以自检状态:
gh auth status
如果你同时有多个账号/组织,记得确认当前终端环境在用哪个用户与 token 权限范围(scope),避免后续命令因为权限不足而失败。
1)克隆仓库
gh repo clone OWNER/REPO
2)在当前目录初始化并关联远端
gh repo create
3)查看 PR 列表 / 详情
gh pr list
gh pr view 123
4)创建 PR(交互式引导)
gh pr create
5)直接在浏览器打开某个 PR/Issue
gh pr view 123 --web
gh issue view 456 --web
6)检查 CI(Actions)运行情况
gh run list
gh run view --log
7)快速看 Issue 列表并创建 Issue
gh issue list
gh issue create
8)把常用仓库设为默认,减少重复输入
gh repo set-default OWNER/REPO
技巧 A:结合 JSON 输出做简单筛选
很多命令支持 --json 输出,你可以把它接到你熟悉的过滤工具里做快速查询(比如只看某个作者的 PR)。示例(字段仅作演示):
gh pr list --json number, ,author
技巧 B:把高频命令做成 shell alias
例如把“列出最近 PR”做成短命令,减少记忆成本;不同 shell 的 alias 写法不同,按你自己的终端配置即可。
技巧 C:把“打开网页”作为兜底
当你不确定某个参数怎么写时,先用 --web 打开网页处理一次,之后再回到终端把流程固化下来。
1)提示权限不足 / 404:通常是 token scope 不够,或当前账号没有目标仓库权限。先跑 gh auth status 确认身份,再检查组织/仓库权限。
2)公司网络下登录失败:优先使用浏览器登录方式;如果有代理/证书等限制,按公司网络策略配置后再试。
3)命令输出太长:先用 --limit(如果支持)降低数量,再用 --json + 筛选只保留你需要的字段。
做到这里,你已经可以把“查 PR - 看 CI - 提交修改 - 再看 CI”的大部分动作留在终端里完成了。后续想更深一层,可以从官方文档的扩展(extensions)和 Actions 相关命令开始挖。