用途:GitHub CLI(gh)是 GitHub 官方命令行工具,让用户在终端中完成 GitHub 的常见操作,资料称可在命令行与 GitHub 无缝协作。
安装与验证:macOS 用 brew install gh;Linux 用官方 apt 源脚本安装;Windows 用 winget install --id GitHub.cli。安装后用 gh --version 验证。
认证:gh auth login 交互登录,支持 --hostname 指定企业主机、--with-token 从标准输入读取令牌;gh auth status 查看状态,gh auth switch 切换账号,gh auth refresh 刷新或增删权限范围,gh auth setup-git 配置 git 凭据助手,gh auth token 输出令牌。
主要能力:顶层命令覆盖仓库(repo:创建、克隆、列表、查看、编辑、归档、删除、fork、同步等与自动链接、部署密钥、gitignore、许可证模板)、议题(issue:创建、列表、查看、编辑、关闭、评论、锁定、置顶、转移、删除,以及 develop 生成草稿 PR)、拉取请求(pr:创建、列表、状态、检出、审查、合并、回滚、更新分支等)、Actions(workflow 与 run:列出、运行、查看、重跑、取消、下载产物,cache 删除与列表)、项目(project 及其字段与条目子命令)、发布(release 创建、上传、下载、校验、删除)、Gist(gist)、Codespaces(codespace)、组织(org list)、搜索(search code/commits/issues/prs/repos)、规则集(ruleset)、秘密与变量(secret、variable)、SSH 与 GPG 密钥、别名(alias)、扩展(extension)、API 请求(api)、产物证明(attestation)、浏览器打开(browse)与状态总览(status)。
配置:gh config list/get/set/clear-cache 管理编辑器、git 协议、分页与提示等;也支持 GH_TOKEN、GH_HOST、GH_PROMPT_DISABLED、GH_EDITOR、GH_PAGER、GH_TIMEOUT、GH_REPO 等环境变量。
适用场景:适合在脚本与终端工作流中批量管理仓库、议题与 PR,查询 Actions 运行状态,或在自动化中使用 GH_TOKEN 完成无需交互的操作。
限制:资料仅给出上述命令与选项,未说明收费、价格、平台兼容范围、执行效果或性能表现;使用前需先完成安装与认证。