Linux 下载、安装 GitHub CLI，GitHub官方命令行工具，PR、Issue、Release终端直达（附安装包gh_2.101.0_linux_amd64.tar.gz）

发布于 2026/9/16 · 1 阅读
GitHub CLIgh命令行工具GitHubPull RequestIssueLinux开发者工具版本控制开源软件
GitHub CLI 是 GitHub 官方命令行工具，PR、Issue、Release、Actions 终端直达。本文提供 GitHub CLI v2.101.0 中文文档、发布说明中英对照，以及 Linux x86_64 官方安装包。

文章目录

封面.png

1. GitHub CLI 简介

GitHub CLI（命令名 gh）是 GitHub 官方出品的命令行工具，把拉取请求（Pull Request）、议题（Issue）、工作流运行、版本发布等 GitHub 核心概念直接带进终端，就在你使用 git 和代码工作的地方完成整个 GitHub 工作流，不必再在浏览器和终端之间来回切换。项目使用 Go 语言编写，采用 MIT 许可证开源，支持 GitHub.com、GitHub Enterprise Cloud 和 GitHub Enterprise Server。

在 gh 出现之前，社区长期使用 GitHub 联合创始人 Chris Wanstrath 开发的非官方工具 hub，它以 git 代理的形式工作。2020 年 2 月 12 日，GitHub 官宣 GitHub CLI 进入公测，3 月正式开源，2020 年 9 月 17 日发布 1.0 正式版；2021 年引入扩展系统（Extensions），允许社区为 gh 编写自定义命令。此后 gh 成为官方推荐的标准工具，hub 则进入维护状态。GitHub 官方托管的 Actions 运行器（runner）也预装了 gh 并每周更新。截至 2026 年 9 月，项目在 GitHub 上拥有约 53,100 颗星标、6,700 余个 Fork、1,600 多名贡献者。

GitHub CLI 的核心特点：

  • 官方出品、深度集成：GitHub 团队自己维护，认证、API、鉴权与 GitHub 平台同步演进，无需追赶第三方工具的适配节奏
  • 覆盖 GitHub 全部核心流程：gh pr 管理 Pull Request、gh issue 管理议题、gh run/gh workflow 驾驶 GitHub Actions、gh release 管理版本发布、gh repo 操作仓库、gh gist 管理代码片段
  • 可脚本化：gh api 直接调用 REST 与 GraphQL API，配合 --jq/--template 处理输出；gh alias 把常用参数组合固化为别名，GH_TOKEN 环境变量支持无交互运行
  • 可扩展：gh extension 安装社区扩展，如官方维护的 gh copilot 可在终端获得 AI 辅助；v2.101.0 的 README 还介绍了用内置 gh skill 命令为编码智能体安装技能
  • 供应链安全：自 v2.93.0 起采用不可变发布（immutable releases），自 2.50.0 起生成可加密验证的构建来源证明（Build Provenance Attestation），基于 Sigstore 公益 PKI，可用 gh at verify 校验
  • 跨平台、许可证宽松：macOS、Windows、Linux 全平台支持，MIT 许可证可自由用于商业项目

2. v2.101.0 版本亮点

该版本汇集了 6 位贡献者 的 42 条 贡献。

GitHub CLI v2.101.0 于 2026 年 9 月 15 日发布，是继 v2.100.0 之后的常规功能版本，重点是关系 Linux 用户的软件包仓库签名密钥轮换，以及认证流程的剪贴板改进。

Linux 软件包仓库签名密钥轮换（Linux 用户重点关注）：

  • 官方 APT 与 RPM 仓库以及单个 RPM 软件包，现在仅使用新的 PGP 密钥签名，密钥指纹为 7F38BBB59D064DBCB3D84D725612B36462313325
  • 2026 年 4 月 8 日之前从官方 APT 或 RPM 仓库安装 gh 且尚未刷新密钥环（keyring）的用户，可能遇到软件包安装或更新失败，需按官方轮换指引检查并更新密钥环
  • 通过 GitHub Releases 下载二进制、Homebrew、其他包管理器或源码编译安装的用户不受影响，本整合包属于此类

认证体验改进：

  • gh auth login 与 gh auth refresh 现在默认把 OAuth 设备码复制到剪贴板，省去认证过程中手动复制的一步
  • 如需持久关闭，执行 gh config set clipboard disabled；单次调用中显式指定的剪贴板选项仍然优先

缺陷修复与清理：

  • 仓库克隆改用 API 的 SSH URL
  • 交互式创建仓库时校验仓库名称合法性
  • 遥测（telemetry）数据在命令调用结束时收尾落盘，并记录附件操作次数
  • 将 gh 自身的路径传递给扩展程序
  • 修复所有者名称大小写不一致时删除远程分支出错的问题
  • 移除 gh repo garden 实验命令，下线多账号迁移逻辑

此外还有 Go 升级到 1.27.1、十余项依赖更新以及构建流程与验收测试的多项改进。

3. 获取安装包

如果访问 GitHub 不便，安装包及中文文档：https://hanshuixin.org/go/226G（内含 gh_2.101.0_linux_amd64.tar.gz、README 中英对照、发布说明中英对照、LICENSE 和源码）。

适用于 Linux x86_64（amd64）。

GitHub CLI 其他版本：https://hanshuixin.org/resource/software_integrated_package/Linux/GitHub%20CLI

Linux安装cli-v2.101.0（gh_2.101.0_linux_amd64）.zip
├── gh_2.101.0_linux_amd64.tar.gz
├── Linux安装cli-v2.101.0（gh_2.101.0_linux_amd64）.pdf
├── README/
│   ├── README.md
│   └── README-中文版.md
├── 发布说明/
│   ├── RELEASE-NOTES.md
│   └── RELEASE-NOTES-中文版.md
├── 源码/
│   └── cli-v2.101.0.zip
└── LICENSE

4. 安装

gh_2.101.0_linux_amd64.tar.gz 是 GitHub CLI 官方发布的 Linux amd64/x86_64 二进制发行包，使用 gzip 压缩，不绑定特定发行版。解压后得到 gh_2.101.0_linux_amd64/ 目录，其中 bin/gh 是可执行文件，share/man/man1/ 下是手册页：

# 解压
tar -xzf gh_2.101.0_linux_amd64.tar.gz

# 部署可执行文件到系统路径（推荐 /usr/local/bin）
sudo mv gh_2.101.0_linux_amd64/bin/gh /usr/local/bin/

# （可选）安装手册页
sudo cp -r gh_2.101.0_linux_amd64/share/man/man1 /usr/local/share/man/

# 验证安装
gh --version

整合包内的安装包与官方发布的同名文件逐字节一致，其 SHA-256 为 9bca2d1c16825f109907a23307628a2f0698fbf99662b73a5cf0b020293072b8，可与官方 gh_2.101.0_checksums.txt 核对。

若发行版的包管理器已提供 GitHub CLI，也可以直接用包管理器安装，但版本通常滞后于上游；若使用官方 APT/RPM 仓库，请留意第 2 章提到的 PGP 密钥轮换。

5. 使用

5.1 登录认证

多数命令需要先登录 GitHub 账号：

# 交互式登录（v2.101.0 起设备码默认复制到剪贴板）
gh auth login

# 查看登录状态
gh auth status

# 刷新认证凭据
gh auth refresh

在 CI 或脚本中可不交互，用环境变量 GH_TOKEN（或 GITHUB_TOKEN）提供访问令牌（token）：

export GH_TOKEN=your_token_here

5.2 仓库操作

# 克隆仓库
gh repo clone cli/cli

# 创建仓库（交互式，也可用 --public/--private/--internal 指定可见性）
gh repo create my-project

# Fork 当前仓库
gh repo fork

# 查看仓库信息，加 --web 在浏览器中打开
gh repo view --web

# 同步 Fork 与上游
gh repo sync

5.3 Pull Request 工作流

# 从当前分支创建 PR，交互式生成标题与描述
gh pr create

# 查看当前分支 PR 状态与详情
gh pr status
gh pr view

# 查看检查项（CI）运行情况
gh pr checks

# 在本地检出他人的 PR
gh pr checkout 1234

# 合并 PR，merge/squash/rebase 三种方式可选
gh pr merge --squash

5.4 议题管理

# 创建议题
gh issue create

# 列出开放议题
gh issue list --state open --limit 20

# 查看详情与评论
gh issue view 42 --comments

5.5 GitHub Actions 工作流

# 列出最近的工作流运行
gh run list

# 实时跟踪一次运行
gh run watch

# 查看失败的日志
gh run view --log-failed

# 手动触发工作流
gh workflow run deploy.yml

5.6 Release 与 Gist

# 创建发布，--generate-notes 自动生成变更说明，可同时上传附件
gh release create v1.0.0 --generate-notes ./dist/app.tar.gz

# 列出与下载发布
gh release list
gh release download v1.0.0

# 快速创建代码片段
gh gist create main.go --public

5.7 直接调用 API 与脚本化

gh api 可以直接调用 REST 与 GraphQL API，输出 JSON，并支持内置的 --jq 过滤（语法与 jq 相同，无需另装 jq）：

# 查看仓库星标数
gh api repos/cli/cli --jq '.stargazers_count'

# 分页列出组织全部仓库名称
gh api orgs/{owner}/repos --paginate --jq '.[].name'

把常用参数组合固化为别名：

gh alias set bugs 'issue list --label=bug'
gh alias list

5.8 扩展与智能体技能

社区扩展用 gh extension 安装管理，例如官方维护的 Copilot 扩展可在终端获得 AI 辅助；为编码智能体准备的 gh 使用技能则通过内置 gh skill 命令安装：

# 浏览并安装扩展
gh extension browse
gh extension install github/gh-copilot

# 为编码智能体安装 gh 技能（用户级）
gh skill install cli/cli gh --scope user

# gh 发布新版本后更新技能
gh skill update gh