用途:GitHub CLI(gh)让用户从命令行无缝操作 GitHub,覆盖仓库、议题(issue)、拉取请求(pr)、Actions、项目、发行版、Gist、Codespaces、组织与扩展等。资料标注版本为 2.85.0(截至 2026 年 1 月)。
安装:macOS 使用 brew install gh;Linux 依次导入 keyring、添加 apt 源、执行 sudo apt update 与 sudo apt install gh;Windows 使用 winget install --id GitHub.cli。安装后用 gh --version 验证。
认证:交互登录 gh auth login,也支持 --hostname、--with-token < mytoken.txt、--web、--clipboard、--git-protocol 等;用 gh auth status 查看状态,gh auth switch 切换账号,gh auth logout 退出,gh auth setup-git 配置 git 凭据助手,gh auth token 查看令牌,gh auth refresh --scopes 刷新权限。
主要能力(按命令分组):auth 认证;browse 在浏览器打开仓库/路径/议题/PR/提交及 Actions、Projects、Releases、Settings、Wiki 页面;repo 仓库的创建(--public/--private/--license/--gitignore/--template)、克隆、列表、查看、编辑、改名、归档、删除、复刻、同步、自动链接、部署密钥、set-default 等;issue 议题的创建、列表、查看、编辑、关闭/重开、评论、状态、置顶、锁定、转移、删除及 gh issue develop 生成草稿 PR;pr 拉取请求的创建(--draft/--base/--head/--reviewer/--labels/--issue)、列表等;run 与 workflow 管理 Actions 工作流运行与缓存;codespace、gist、project、release、secret、variable、ssh-key、gpg-key、label、ruleset、search、extension、alias、api、attestation、config、completion、status 等子命令。
配置:gh config list/get/set 设置 editor、git_protocol、prompt、pager,gh config clear-cache 清缓存;环境变量支持 GH_TOKEN、GH_HOST、GH_PROMPT_DISABLED、GH_EDITOR、GH_PAGER、GH_TIMEOUT、GH_REPO、GH_ENTERPRISE_HOSTNAME。
限制:资料未提供价格、收费、平台支持范围、效果数据或完整脚本示例;部分命令的详细语义与最新版本差异未在资料中说明,需以实际命令帮助为准。