很多人用 GitHub 时只停留在网页：点来点去、开一堆标签页、复制链接、切换账号……其实 GitHub 官方出了一个非常实用的命令行工具 GitHub CLI（简称 gh），把常用操作（克隆仓库、创建 PR、查看 Issue、管理多账号登录等）都收进一套命令里。
这篇教程按“能上手、能提效”的思路，带你完成：安装 gh → 登录（含多账号）→ 常用命令清单 → 常见坑排查。
GitHub CLI 官网：https://cli.github.com/
GitHub CLI 项目页：https://github.com/cli/cli
官方文档：https://docs.github.com/en/github-cli
如果你经常遇到这些情况，gh 会非常省时间：
以下命令示例都可以直接复制使用；如果你更喜欢图形化，也可以从官网下载安装包。
macOS（Homebrew）
brew install gh
Windows（winget）
winget install --id GitHub.cli
Ubuntu / Debian（apt）（不同发行版步骤可能略有差异，以官网说明为准）
sudo apt install gh
安装完成后，先检查版本确认可用：
gh --version
推荐用浏览器授权登录（安全、也省得手动复制 Token）。
gh auth login
常见选项建议：
登录完成后，用下面命令确认当前身份与权限：
gh auth status
如果你同时有个人和公司账号，建议用 gh 的“多主机/多身份”能力来管理，而不是到处退出重登。
添加另一个账号：
gh auth login
查看当前保存的认证信息：
gh auth status
在多个账号之间切换（如果你的版本支持）：
gh auth switch
小提示：
1）快速克隆仓库
gh repo clone OWNER/REPO
2）在浏览器打开当前仓库/PR
gh repo view --web
gh pr view --web
3）创建 PR（减少网页表单时间）
gh pr create
4）拉取并切换到某个 PR 的分支（Review 很舒服）
gh pr checkout 123
5）列出 Issue / PR（配合筛选）
gh issue list
gh pr list
6）查看 Actions 运行结果（排查 CI）
gh run list
gh run view --log
gh 的登录更多是“API 权限/网页操作”的授权；而你日常 git clone/push 走的是 Git 传输协议（HTTPS 或 SSH）。
如果你经常在多台设备协作、或希望免输入密码，SSH 往往更顺手；但多账号场景下，SSH Key 管理要更清晰（不同主机/不同 key）。
建议做法：
Q1：gh 能用，但 push 提示权限不足？
A：这通常是 Git 远端（HTTPS/SSH）与 gh 授权不是一回事。先检查远端地址：
git remote -v
Q2：公司仓库要求 SSO，登录后还是访问不到？
A：按提示在网页完成 SSO 授权；必要时重新运行 gh auth login 或在浏览器里确认已授权该组织。
Q3：我只想做最小配置，先能用起来
A：最小路径就是：安装 → gh auth login → 常用 gh repo clone / gh pr create / gh pr checkout。等你真正感受到省时，再逐步把命令融进自己的工作流。
