GitHub CLI（命令名 gh）是 GitHub 官方的命令行工具，适合把常用操作（克隆仓库、创建/查看 PR、处理 Issue、查看 Actions 等）从浏览器搬到终端。对经常在多台电脑之间切换的人来说，gh 还能把认证与配置做得更可控。
Windows（winget）
打开 Windows Terminal / PowerShell，执行：
winget install --id GitHub.cli
安装后用 gh --version 验证。
macOS（Homebrew）
brew install gh
如果你没有 Homebrew，可参考：https://brew.sh/
在终端运行：
gh auth login
建议选择 GitHub.com + HTTPS + Login with a web browser。这样更安全，也更不容易输错。
登录后可用：
gh auth status
确认当前账号、Token 范围与是否生效。
1）克隆仓库
gh repo clone OWNER/REPO
2）查看与创建 PR
gh pr list
gh pr view --web（用浏览器打开当前 PR）
gh pr create --fill（用提交信息自动填标题/描述，减少重复写）
3）处理 Issue
gh issue list
gh issue create -- "..." --body "..."
4）看 CI 状态（Actions）
gh run list
gh run view --log
自动补全：不同 Shell 的开启方式略有区别，建议直接按官方文档配置（能避免复制过期命令）：
https://docs.github.com/en/github-cli/github-cli
别名：把长命令缩短成你习惯的风格，例如：
gh alias set prw "pr view --web"
以后输入 gh prw 就能一键打开当前 PR。
多账号：在不同公司/个人账号间切换时，先看当前状态：
gh auth status
需要切换时可重新执行 gh auth login 并选择对应方式（或在不同环境变量/配置目录隔离）。
1）命令找不到：确认安装路径已加入 PATH；关闭并重新打开终端后再试 gh --version。
2）权限不足：用 gh auth status 查看 Token 范围；对私有仓库、Actions、Packages 等可能需要额外权限。
3）公司网络/代理问题：优先在浏览器端完成登录，再回到终端执行操作；必要时检查系统代理设置是否影响 GitHub 访问。
把 gh 装好并完成登录后，建议先用 gh repo clone、gh pr create、gh issue list 这三类命令建立肌肉记忆；再按需补全与别名，日常效率会提升得非常明显。
