如果你经常在浏览器里反复点「仓库」「Pull Request」「Issue」「Actions」,其实很多操作都可以在终端里用更少的步骤完成。GitHub CLI(命令为 gh)相当于把常用的 GitHub 功能搬到命令行:查看仓库信息、搜索与管理 Issue、创建/审核 PR、拉取 PR 到本地测试、甚至打开网页对照等。
参考链接:https://docs.github.com/en/github-cli
先在终端/命令提示符里执行一次:如果能输出版本号,就说明已经安装。
gh --version
Windows 10/11 推荐直接用 winget 安装(系统自带或通过 Microsoft Store 更新)。管理员权限不是必须,但如果你遇到权限提示,请按系统要求操作。
winget install --id GitHub.cli
安装完成后重新打开终端,再次确认:
gh --version
macOS 用户通常用 Homebrew 管理命令行工具。没有 Homebrew 也可以去官网下载包,但本文以 Homebrew 为例(更方便后续升级)。
brew install gh
升级时:
brew upgrade gh
不同发行版的包管理器不一样,建议优先参考官方安装页,选择与你系统匹配的方式。这里给一个通用思路:先在包管理器里搜索,再安装。
gh --help
如果系统仓库版本偏旧,可以按官方文档使用官方源/二进制包(遵循你所在环境的安全策略,不要随意运行不明脚本)。
登录的关键点是「授权」,而不是“拿到密码”。gh auth login 会引导你选择 GitHub.com / 企业版地址、选择 HTTPS 或 SSH、以及是否把 Token 写入系统 Keychain/凭据管理器。
gh auth login
完成后你可以检查当前登录状态:
gh auth status
提示:如果你在公司设备上,建议开启系统层的凭据存储(Keychain/Windows Credential Manager),避免把 Token 明文写在配置文件里。
1)快速查看自己相关的 PR(需要时可加筛选条件):
gh pr list
2)创建 PR(自动打开交互式引导,适合新手):
gh pr create
3)在本地检出某个 PR 进行测试(不用手动找分支名):
gh pr checkout 123
4)查看 PR 详情(包含 checks、评论等):
gh pr view 123
5)把 PR 在浏览器里打开对照(需要图形界面时很方便):
gh pr view 123 --web
6)列出 Issue / 创建 Issue:
gh issue list
gh issue create
7)查看当前仓库信息(确认远端、默认分支等):
gh repo view
8)把仓库直接克隆到本地(支持 owner/repo 简写):
gh repo clone owner/repo
1)命令找不到:多数是 PATH 没刷新。Windows 重新打开终端;macOS/Linux 重新打开 shell 或执行 hash -r。
2)登录成功但没有权限:可能是授权范围不够或登录了错误账号。用 gh auth status 确认当前账号;必要时先登出再登录。
3)企业 GitHub:如果你使用 GitHub Enterprise Server,需要在登录时选择对应 Host,或按文档配置(不要把内部地址写错)。
把下面这个组合当作固定动作:先列出待处理 PR,再打开详情,最后需要时检出到本地测试。
gh pr list
gh pr view 123
gh pr checkout 123
当你熟悉后,可以把常用命令做成终端 alias 或脚本(注意公司环境的安全规范)。