gh 是 GitHub 命令行工具,用于在终端中直接操作 GitHub 上的各类资源。该页面提供了从安装、认证到常用命令的速查内容。
用途 面向希望不离开命令行管理 GitHub 的开发者。页面说明其覆盖仓库(repos)、拉取请求(PRs)、议题(issues)、发布(releases)、代码片段(gists)与工作流(workflows)等操作。
安装与验证 macOS 使用 brew install gh;Linux 使用 apt install gh。安装后可用 gh --version 验证。页面提示:在程序化调用命令时,应始终使用 --json <fields> 标志输出指定字段。
认证 使用 gh auth login 登录,使用 gh auth status 检查认证状态。
主要能力(按资源分组的常用命令) 仓库:gh repo list 列出自己的仓库;gh repo list <owner> 列出用户或组织的仓库;gh repo create <name> --public / --private 创建公开或私有仓库;gh repo clone <owner/repo> 克隆;gh repo view <owner/repo> 查看详情;gh repo fork <owner/repo> 复刻;gh repo delete <owner/repo> --yes 删除。 拉取请求:gh pr list 列出打开的 PR,--state all 列出全部;gh pr create --title "Fix" --body "Description" 创建;gh pr view <number> 查看详情;gh pr checkout <number> 检出到本地;gh pr merge <number> 合并,--squash 使用压缩合并;gh pr close <number> 关闭;gh pr review <number> --approve 批准;gh pr diff <number> 查看差异;gh pr checks <number> 查看 CI 检查状态。 议题:gh issue list 列出打开的议题;gh issue create --title "Bug" --body "Description" 创建;gh issue view <number> 查看详情;gh issue close / reopen <number> 关闭或重新打开;gh issue comment <number> --body "Comment" 添加评论;gh issue edit <number> --add-label bug 添加标签。 发布:gh release list 列出;gh release create v1.0.0 创建,加 --generate-notes 自动生成说明;gh release view <tag> 查看;gh release download <tag> 下载资源;gh release delete <tag> 删除。 工作流与运行:gh workflow list 列出工作流;gh workflow run <name> 触发;gh run list 列出最近运行;gh run view <id> 查看;gh run watch <id> 监视进行中的运行;gh run rerun <id> 重新运行。 代码片段:gh gist list 列出;gh gist create file.txt 从文件创建,加 --public 创建公开片段;gh gist view <id> 查看;gh gist edit <id> 编辑。 API:gh api repos/{owner}/{repo} 发起 GET 请求;gh api repos/{owner}/{repo}/issues --method POST --field title="Bug" 发起 POST;gh api graphql -f query='{ viewer { login } }' 执行 GraphQL 查询。
使用方式与常用全局标志 --json <fields> 以 JSON 输出指定字段;--jq <expression> 用 jq 过滤 JSON;--repo <owner/repo> 指定目标仓库;--limit <n> 限制结果数量;--web 在浏览器中打开。
适用场景 适合在终端中批量或脚本化处理 GitHub 仓库、PR、议题、发布与 CI 运行状态查询等任务。
限制 页面仅提供命令速查,未说明使用额度、权限范围、版本要求或错误处理等细节,这些内容暂未提供。