GitHub 官方提供的 GitHub CLI(命令名:gh),可以把很多日常操作(拉取仓库、创建 PR、审核代码、管理 Issue、看 CI 状态等)从浏览器搬到终端里完成。它的优势不是“更酷”,而是更快、可脚本化、少点鼠标。
macOS(Homebrew)
brew install gh
Windows(winget)
winget install --id GitHub.cli
Ubuntu / Debian(apt)
不同发行版的仓库配置略有差异,建议直接按官方文档步骤走:https://github.com/cli/cli#installation
第一次使用建议先登录。gh 支持浏览器授权,也支持粘贴 Token。大多数个人账号用浏览器授权最省心。
gh auth login
建议选择 HTTPS 作为 Git 协议(除非你已经把 SSH 多账号配置得很熟)。登录完成后可自检:
gh auth status
如果你在公司环境需要走代理,优先把代理配置在系统或终端里(例如设置环境变量),再重新执行登录。
克隆仓库(会自动选择你已登录账号的最佳方式):
gh repo clone owner/repo
创建仓库(支持交互式配置可见性、是否初始化 README 等):
gh repo create
在终端快速打开项目主页:
gh repo view --web
创建 PR(推荐交互式,能选 分支、填写标题与描述):
gh pr create
查看 PR 列表:
gh pr list
检出某个 PR 到本地分支(适合快速复现问题或本地跑测试):
gh pr checkout 123
在浏览器打开当前 PR:
gh pr view --web
看 CI 状态与检查项(对“为什么不能合并”很有用):
gh pr checks
创建 Issue:
gh issue create
列出 Issue(可按指派人、标签等过滤):
gh issue list
查看某个 Issue 详情:
gh issue view 456
1)提示权限不足 / 需要 SSO:一些组织开启了 SSO 或更严格的权限策略。此时请在组织页面完成 SSO 授权,或让管理员为你开通需要的权限范围。
2)多账号切换:gh 支持多个认证上下文,建议把不同账号分别登录后按需切换,避免把个人 Token 用在公司仓库上。
3)网络问题导致登录失败:优先检查代理与 DNS;必要时用浏览器授权重试。确认能正常访问 https://github.com/ 后再操作。
如果你每天都在做“看 PR 列表 → 打开 PR → 看检查项 → 需要时检出跑一下”,可以把这一串固定成:
gh pr list
gh pr view --web
gh pr checks
配合终端的历史命令与别名(alias),你会明显减少在网页里来回点的时间。