如果你经常在 GitHub 上做这些事:克隆仓库、看 Issue、处理 Pull Request、查 CI 状态、创建 Release,那么 GitHub CLI(gh) 会非常省时间:不用频繁切回浏览器,终端里就能把流程走完。
工具主页:https://cli.github.com/(官方)
Windows(winget)
winget install --id GitHub.cli
macOS(Homebrew)
brew install gh
Ubuntu / Debian(apt)
sudo apt update
sudo apt install gh
安装完成后先确认版本:
gh --version
最稳妥的方式是让 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
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
你可以把长命令设置成别名,团队也能共享同一套习惯(写进文档或 onboarding 清单)。例如:
gh alias set co "pr checkout"
gh alias set pv "pr view"
gh alias set il "issue list"
查看当前别名:
gh alias list
1) 没权限推送 / PR 操作失败:优先检查登录状态与授权范围。
gh auth status
2) 公司网络代理 / 证书问题:建议先确认系统代理设置是否对终端生效;必要时按公司 IT 规范配置环境变量。
3) HTTPS 与 SSH 混用导致拉取异常:统一仓库 remote(尤其是多机器同步时)。
git remote -v
如果你不想一下子记很多命令,可以从下面这套开始:
gh auth login(只需第一次)
gh repo clone ...
gh issue list
gh pr create
gh run list
补充参考:项目源码与更新日志 https://github.com/cli/cli