GitHub CLI 离线安装包

它是什么GitHub CLI（命令行中常写作 gh）是 GitHub 官方命令行工具，把拉取请求、议题与 GitHub Actions 带进终端；

GitHub CLI（命令行中常写作 gh）是 GitHub 官方命令行工具，把拉取请求、议题与 GitHub Actions 带进终端；本页说明如何从官方 Releases 页面取回离线包、在无网络机器上完成部署并运行 gh auth login 验证。

👤

作者：谢林峰 | 更新：2026-10-09

软件信息

更新 2026-10-09

详细介绍

简介

GitHub CLI（命令行里常写作 gh）是 GitHub 官方的命令行工具，它把拉取请求、议题、GitHub Actions 以及其他 GitHub 功能带进终端，让开发者不必打开网页，就能在一个地方完成日常协作。工具本身免费且开源，覆盖 macOS、Windows、Linux 三类操作系统，适合需要在内网、机房或网络受限环境中准备开发工具的团队：先从官方 Releases 页面取回对应平台的离线包，再按引导完成部署，全程不必逐个下载依赖。包名、版本与可用架构以官方页面为准。

核心功能

把拉取请求（pull request）带进终端，围绕 PR 的日常处理不必再切换到网页。
管理议题（issues）：从提出问题到跟进处理都在命令行完成，与仓库操作处在同一个工作面。
访问 GitHub Actions：官方文档明确把 GitHub Actions 列为可从终端直接使用的功能之一。
覆盖从处理问题到发布软件包的完整工作流，流程各环节不必在网页与终端之间来回切换。
调用 GitHub API：可用命令直接与 GitHub 接口交互，便于把平台能力接入脚本或自动化流程。
身份验证：官方快速入门要求在终端运行 gh auth login，验证通过后命令即可访问你的账号资源。
免费且开源：官方站点 https://cli.github.com/ 标注 Free and open source，源码托管在 https://github.com/cli/cli，可自行审阅与构建。

使用场景

网络受限的开发机：外网不可达时，用离线包让 gh 在本机可用，不必逐个下载依赖。
内网 CI 与构建机：在隔离网络的流水线机器上提供 gh 命令，供脚本调用 GitHub API 或触发 Actions。
Windows 图形化部署：下载 .msi 后双击，按图形化引导逐步完成，适合不习惯命令行的同事。
团队统一取包：按操作系统与架构从官方 Releases 页面选择对应文件，保证成员环境一致。
终端内闭环工作：从处理议题、跟进 PR 到发布软件包都在一个地方完成，减少网页切换。
跨平台混用环境：macOS、Windows、Linux 三类机器并存时，用同一套 gh 命令保持操作习惯一致。

安装与获取步骤

确认平台：打开 https://cli.github.com/ 与快速入门文档 https://docs.github.com/zh/github-cli/github-cli/quickstart ，确认目标机器属于 macOS、Windows 还是 Linux。
选择获取渠道：进入 GitHub CLI 官方 Releases 页面，按操作系统与架构挑选对应文件；Windows 场景可取 .msi 安装文件，具体可选版本以官方页面为准。
离线传输：在可联网机器上下载完成后，把文件通过 U 盘或内网共享拷贝到目标机器，目标机全程不必访问外网。
执行部署：Windows 双击 .msi 按图形化引导逐步完成；其他平台按 GitHub CLI 仓库中 Install 部分给出的说明操作。
身份验证：在终端运行 gh auth login，按提示完成与 GitHub 的身份验证，这是官方快速入门给出的首个命令。
验证结果：在终端输入 gh 相关命令，能回显帮助信息即说明可执行；若机器可用包管理器，也可参考 winget install --id 形式的命令，参数以官方页面为准。

与同类方案的区别

与 Git 的分工：Stack Overflow 上的问题 64763225 专门讨论 git 与 gh 的区别，涉及 clone 等操作该由谁完成，可先读该问答再做选择。
与其他平台 CLI：AtomGit CLI（命令 ag）是 AtomGit 官方合作开发的命令行工具，面向另一代码托管平台，命令习惯与 gh 并不通用。
离线打包的另一种做法：claude-code-offline 项目每天从 npm 拉取最新版、构建 Linux 与 Windows 双平台离线包，经自动化测试后发布到 GitHub Releases；gh 的离线获取则直接取官方 Releases 上的现成文件。
同类工具的取包方式：LeanCloud 的命令行工具同样要求 Windows 用户到 GitHub releases 按系统版本选择 32 位或 64 位 msi，按系统选包是通行做法。

注意事项

本文不给出具体版本号、文件大小或校验值，包名与可用版本一律以官方 Releases 页面为准。
离线包务必来自 GitHub CLI 官方 Releases 页面，来源不明的第三方重打包文件需先核对出处再使用。
gh 首次使用需要身份验证：在终端运行 gh auth login；内网隔离环境下该步骤可能受网络策略限制，需提前确认可达性。
Windows 上 .msi 与 winget 两种取包方式二选一即可，命令参数以官方页面为准，避免混用造成环境冲突。
macOS 走 Homebrew 时需要机器能访问对应软件源，访问不到就改走离线包路线。
gh 与 git 解决的问题不同，遇到「该用哪个」的判断时参考社区问答，不要假设二者可以互相替代。
文中链接均为完整 URL，可直接复制到浏览器打开；关于工具本身的官方说明见 https://docs.github.com/zh/github-cli/github-cli/about-github-cli 。

更新记录

最近更新：2026-10-09

软件参数速览

本站更新时间2026-10-09

github_project

常见问题

Windows 上离线部署 gh 应该下载哪个文件？

到 GitHub CLI 官方 Releases 页面下载 .msi 文件，双击后按图形化引导逐步完成，适合网络受限、需手动处理的用户。具体可选版本以官方页面为准。

内网机器无法访问外网，如何取得 gh 的离线包？

在一台可联网的机器上打开官方 Releases 页面下载对应系统的文件，再通过 U 盘或内网共享拷贝到目标机，目标机全程不必访问外网。

执行 gh 后提示需要身份验证怎么办？

在终端运行 gh auth login，按提示完成与 GitHub 的身份验证；这是官方快速入门给出的首个命令，验证通过后命令才能访问你的账号资源。

gh 和 git 到底该用哪个？

gh 负责把拉取请求、议题、GitHub Actions 等平台功能带进终端；关于二者分工，Stack Overflow 问题 64763225 有专门讨论，clone 等操作的取舍可参考该问答。

macOS 用 Homebrew 和走离线包有什么差别？

官方站点把 Homebrew 列为 macOS 的获取方式，适合能访问软件源的机器；访问不到源的机器改从官方 Releases 页面取离线包，最终以官方页面说明为准。

如何确认 gh 已经可用？

在终端输入 gh 相关命令，能回显帮助信息即说明可执行；随后运行 gh auth login 完成验证，再开始处理拉取请求或议题等具体任务。

除了 .msi，还有别的获取方式吗？

检索素材中还出现了 winget install --id 形式的命令，参数以官方页面为准；官方文档也把详细说明指向 GitHub CLI 仓库中的 Install 部分。

用 gh 离线部署后能做哪些事？

在终端处理拉取请求、议题与 GitHub Actions，调用 GitHub API，覆盖从处理问题到发布软件包的流程，不必再打开网页来回切换。