gh

GitHub 官方命令行工具

补充说明

gh 管理仓库、PR、Issue、Actions、Release 和 API。认证用 gh auth login，脚本里通常用 GH_TOKEN。

常用示例

gh auth login
gh repo clone owner/repo
gh pr list
gh pr checkout 123
gh run list
gh api repos/owner/repo/pulls

易错点与排错

• token 权限/SSO 不足会 403；先看 gh auth status 和所需 scope。
• 企业版要 --hostname，否则默认连 github.com。
• GH_TOKEN 优先于已登录配置；脚本里注意不要覆盖错。
• gh api 受速率限制；批量操作要看 Retry-After。
• PR/Issue 编号是仓库级的；-R owner/repo 明确目标。
• 不要把 token 写进仓库/命令历史；用环境变量或密钥管理。