Windows 下载、安装 GitHub CLI，GitHub官方命令行工具，在终端管理仓库、PR与Issue（附安装包gh_2.101.0_windows_amd64.msi）

发布于 2026/9/16 · 1 阅读
GitHub CLI命令行工具GitHub版本控制Pull RequestIssue开源软件开发工具WindowsDevOps
GitHub CLI 是 GitHub 官方命令行工具，可在终端管理仓库、PR 和 Issue，支持扩展与智能体技能。本文介绍 v2.101.0 更新亮点与常用命令，并附 Windows 安装包及中文文档。

文章目录

封面.png

1. GitHub CLI 简介

GitHub CLI（命令名为 gh）是 GitHub 官方推出的命令行工具，把拉取请求（Pull Request）、议题（Issue）等 GitHub 核心概念直接搬进终端，让你在使用 git 和编写代码的同一个窗口里完成与 GitHub 的全部交互。项目于 2019 年 10 月在 GitHub 上建立，2020 年 2 月开启公开测试，2021 年 2 月发布 1.0 正式版；在此之前，社区长期使用的非官方工具 hub 扮演着类似角色，而 GitHub CLI 以独立工具的全新设计接过了这一棒。它是用 Go 语言编写的，支持 GitHub.com、GitHub Enterprise Cloud 和受支持的 GitHub Enterprise Server 版本，覆盖 macOS、Windows 和 Linux 三大平台。

截至 2026 年 9 月，GitHub CLI 在 GitHub 上拥有约 4.6 万颗星标、9000 余个 Fork，是 GitHub 官方账号下最受欢迎的开源项目之一。它预装在 GitHub Actions 的官方运行器上并每周更新，几乎所有活跃的开源开发者都在 issue 讨论、代码评审或 CI 脚本里与它打过交道，gh pr create、gh run watch 这类命令已经成为日常词汇。

GitHub CLI 的定位是"git 的搭档"而不是"git 的替代"：git 负责本地的版本控制，gh 负责与 GitHub 平台交互的部分。它的子命令体系覆盖了平台上绝大多数高频操作，还支持社区扩展（extension）、命令别名（alias）、多账户切换，并从 2.100 版本起提供 gh skill 子命令，把官方智能体技能安装给 AI 编码智能体使用。

核心特点：

  • GitHub 官方出品：与平台原生集成，API 行为随 GitHub 功能同步演进，无需担心第三方工具的兼容滞后。
  • 与 git 互补：git 管本地版本控制，gh 管平台交互——创建 PR、查看 CI 状态、管理 Issue 都不用离开终端。
  • 子命令体系完整：gh pr、gh issue、gh repo、gh gist、gh run、gh api 等覆盖日常开发全流程。
  • 可扩展：通过 gh extension 安装社区扩展，也可以用任何语言编写自己的扩展。
  • 智能体友好：内置 gh skill 命令，可把官方智能体技能装进 Claude Code 等 AI 编码工具，让智能体直接驱动 gh。
  • 供应链安全：自 v2.93.0 起发布不可变版本（immutable releases），自 2.50.0 起提供基于 Sigstore 的构建来源证明（Build Provenance Attestation），下载的二进制可以加密验证到源仓库和构建流程。
  • 跨平台一致：Windows、macOS、Linux 使用同一套命令，脚本可以直接迁移；GitHub Actions 官方运行器预装并每周更新。

2. v2.101.0 版本亮点

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

v2.101.0 发布于 2026 年 9 月 15 日，是一个以体验细节打磨为主的常规更新版本，同步升级到 Go 1.27.1。

认证体验改进（本版本重点）：

  • gh auth login 与 gh auth refresh 现在默认把 OAuth 设备码复制到剪贴板，登录时少一步手动复制。想关闭该行为可运行 gh config set clipboard disabled；单次调用时显式指定的剪贴板选项仍然优先生效。

缺陷修复：

  • 仓库克隆改用 API 返回的 SSH URL，避免手工拼接出错。
  • 交互式创建仓库时校验仓库名称的合法性，防止无效名称提交后才报错。
  • 遥测（telemetry）数据改为在命令调用结束时统一收尾，并记录附件操作次数。
  • 把 gh 可执行文件的路径传递给扩展，扩展内部调用 gh 不再依赖 PATH 查找。
  • 修复仓库所有者大小写不一致时删除远程分支出错的问题。
  • 删除了实验性的 repo garden 命令，下线已完成历史使命的多账户迁移逻辑。

平台维护提示：

  • Linux 软件仓库 PGP 签名密钥轮换已于 2026 年 9 月 5 日生效。2026 年 4 月 8 日之前通过官方 APT 或 RPM 仓库安装且未刷新密钥环的 Linux 用户，可能遇到安装或更新失败，需按官方指引更新密钥环。Windows 与 macOS 用户不受影响，通过 Homebrew、GitHub Releases、其他包管理器或源码安装的用户也不受影响。

3. 获取安装包

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

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

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

4. 安装

双击整合包根目录中的 gh_2.101.0_windows_amd64.msi，按向导完成安装。安装程序会自动把 gh 加入系统 PATH 环境变量，无需手动配置。安装完成后打开一个新的命令行窗口（已打开的窗口不会读取新的 PATH），执行 gh --version 验证，输出形如 gh version 2.101.0 即安装成功。

本整合包为 64 位（x64）版本，适用于绝大多数现代 Windows 设备；Windows on ARM 与 32 位设备的用户可在官方发布渠道获取对应架构的版本。

4.1 首次使用的登录认证

gh 的大部分功能需要登录 GitHub 账号后才能使用，这一步是使用的前提。在命令行中运行 gh auth login，按交互提示依次选择：

  1. 账号平台：GitHub.com（或 GitHub Enterprise Server）；
  2. 首选协议：HTTPS（推荐，凭据由 gh 接管）或 SSH；
  3. 认证方式：浏览器登录，或设备码登录。v2.101.0 起设备码会自动复制到剪贴板，在浏览器中粘贴并输入即可完成授权。

登录状态可随时用 gh auth status 查看；退出登录用 gh auth logout；多个账号之间用 gh auth switch 切换。

5. 使用

5.1 仓库操作

gh repo clone owner/repo      # 克隆仓库（比 git clone 多一步上游配置）
gh repo create my-project     # 创建新仓库（交互式）
gh repo fork                  # 把当前仓库 Fork 到自己的账号
gh repo view --web            # 在浏览器中打开当前仓库主页

5.2 管理拉取请求

gh pr create                  # 从当前分支创建拉取请求
gh pr list                    # 列出仓库中的拉取请求
gh pr status                  # 查看与自己相关的 PR 状态
gh pr checkout 123            # 切换到 123 号 PR 的分支本地查看
gh pr checks                  # 查看某个 PR 的 CI 检查结果
gh pr merge --squash          # 压缩合并（也可选 merge/rebase）

5.3 管理议题

gh issue create               # 创建议题
gh issue list --state open    # 列出打开状态的议题
gh issue view 42              # 查看 42 号议题详情与评论
gh issue close 42             # 关闭议题

5.4 GitHub Actions 工作流

gh run list                   # 列出最近的工作流运行记录
gh run watch                  # 实时跟踪一次运行直到结束
gh run view                   # 查看某次运行的日志与产物
gh workflow run build.yml     # 手动触发一个工作流

5.5 API 调用与更多能力

gh api repos/owner/repo       # 直接调用 GitHub REST API，已自动带上认证
gh gist create notes.txt      # 把文件创建为 Gist 代码片段
gh release create v1.0.0      # 创建发布版本并附上产物
gh alias set co 'pr checkout' # 设置命令别名，之后可用 gh co 123
gh extension install owner/gh-xxx   # 安装社区扩展
gh skill install cli/cli gh --scope user   # 安装官方智能体技能