GitHub CLI(gh)提效指南:安装、登录与 PR/Issue 常用命令

这篇适合谁(以及为什么用 gh)

如果你经常在 GitHub 上处理仓库、Issue、Pull Request(PR)或 Actions,那么 GitHub CLI(命令为 gh)可以把一大堆“点来点去”的步骤收敛成可复制、可脚本化的命令,尤其适合:频繁开/看 PR、批量拉取仓库、查询 CI 状态、在终端里快速定位问题的人。

工具地址:https://cli.github.com/

参考链接:https://docs.github.com/en/github-cli

安装:Windows / macOS / Linux 三个平台

macOS(Homebrew)

brew install gh

Windows(WinGet)

winget install --id GitHub.cli

Ubuntu/Debian(apt,示例)

不同发行版的安装方式略有差异,推荐直接按官方说明选择对应包管理器;如果你用的是 apt 系,常见做法是先配置 GitHub 的软件源再安装。

登录与鉴权:把 gh 和你的账号“绑”起来

首次使用建议先登录:

gh auth login

一般选择 GitHub.com,再选择使用浏览器登录(更省事)。登录完成后可以自检状态:

gh auth status

如果你同时有多个账号/组织,记得确认当前终端环境在用哪个用户与 token 权限范围(scope),避免后续命令因为权限不足而失败。

最常用的 8 个命令:把日常工作流“终端化”

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

提效小技巧:别只把 gh 当“命令”,把它当“工作流组件”

技巧 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 相关命令开始挖。

用户评论 (0)

登录后参与讨论

立即登录 注册账号

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

操作成功