GitHub CLI
也称为 gh、gh cli、hub cli
GitHub 的官方命令行工具。其进程为 gh.exe。它不是 GitHub Desktop，也不是 git.exe。
您需要了解的内容
gh.exe 是 GitHub CLI。GitHub Desktop 是另一款应用程序。
GitHub CLI 是官方的 gh 命令。GitHub Desktop 对应的是 GitHubDesktop.exe。Git for Windows 对应的是 git.exe。卸载 Desktop 不会删除 gh。安装 gh 也不会安装 Git Bash。
- 它是什么？
- 用于 GitHub 的 gh 命令
- 与 Desktop 相同吗？
- 否。这是一个命令行工具 (CLI)
- 能否取代 git？
- 否。你仍然需要 git.exe
什么是 GitHub CLI？
GitHub CLI 即 gh.exe。它封装了 GitHub.com 的相关功能。它不是 Git for Windows，也不是 GitHub Desktop。
如果您从未用过它
如果教程提示安装 gh，指的就是来自 cli.github.com 的 GitHub CLI。gh.exe 用于创建拉取请求 (PR) 并与 GitHub API 通信。git.exe 依然是版本控制系统本身。GitHub Desktop 则是图形界面。你可以在没有 gh 的情况下使用 git，但不能用 gh 完全取代每次本地提交所需的 git。
它有什么用？
gh pr create 和 gh issue。Desktop 可以通过鼠标点击实现这些操作。单靠 git.exe 无法免去额外步骤直接创建 GitHub PR。
通过设备代码或浏览器登录 GitHub 进行身份验证。Git Credential Manager 是 git.exe 所使用的另一种助手工具。
GitHub 专用的快捷指令。没有此工具时，git clone 同样可以正常工作。
它适合谁？
- 经常使用终端和 GitHub.com 的开发者
- 不需要 GitHub Desktop 的用户
- 输入 gh 却误以为 Git 缺失的任何人
当前状态
GitHub CLI (2020) 是 GitHub 目前推出的官方命令行工具。官方仍引导 Windows 用户访问 https://cli.github.com/。
它存在多久了？
在早期的 hub 工具之后，GitHub 于 2020 年发布了 gh 作为受官方支持的 CLI。它比 GitHub Desktop (2015) 更晚，比 Git (2005) 晚得多。当前的 Windows MSI 安装包和 winget 软件包即为此产品。
版本
以主要渠道为主。此处并未对所有确切的版本号进行逐一验证。
系统要求
数值遵循发布者的公开指引。实际需求仍会因工作负载而异。
最低配置
| 操作系统 | 根据 GitHub CLI 的说明，需要当前受支持的 64 位 Windows 10 或 Windows 11 版本 |
|---|---|
| 内存 | 该命令行工具体积微小 |
资源占用概况
- CPU 需求
- 跟随您在应用内打开的内容
- 内存需求
- 跟随文档、标签页或库
安装的进程
这些可执行文件属于该产品安装后的组件。
| gh.exe | GitHub CLI |
|---|
启动项组件
gh.exe 不会随 Windows 启动。你需要在终端中运行它。
文件位置
| 典型安装 | C:\Program Files\GitHub CLI\ |
|---|
文件格式
常见问题
gh 可以使用，但找不到 git
请从 git-scm.com 安装 Git for Windows。gh 负责与 GitHub 通信，git 负责与本地仓库交互。
Desktop 中已认证，gh 中未认证
gh auth login 是独立的登录流程。Desktop 中的凭据不会自动转换为 gh 的令牌。
故障排除
where.exe gh
预期路径为 Program Files\GitHub CLI\gh.exe。GitHubDesktop.exe 是图形界面程序的路径。
从 cli.github.com 安装或使用 winget GitHub.cli
Downloads 文件夹中来源不明的随意 gh.exe 应当忽略。
gh auth status
显示此 CLI 的登录状态。它不会列出 Sourcetree 的账户。
替代方案
需要图形界面请使用 GitHub Desktop。本地版本控制请使用 git.exe。旧版 hub 二进制文件不是当前受支持的官方 CLI。
官方帮助与下载
请先从软件厂商处着手。随意的 exe 网站并不是支持渠道。
| 下载 | cli.github.com/ 官方安装程序或厂商页面 |
|---|---|
| 帮助 | cli.github.com/manual/ 厂商支持 |
| 官方网站 | cli.github.com/ 请从此处开始，而非随意的 exe 托管网站 |
| 手册 | cli.github.com/manual/ gh pr、gh repo 与认证 |
相关硬件
该命令行工具极其小巧。连接 GitHub 的网络环境通常是唯一的性能瓶颈。
技术细节
技术细节
厂商版本号会发生变动。本文不锁定特定内部版本。
来源与验证
记录的来源标签：August 2026。此标签并不代表已完成独立验证。 我们的研究方式.
- GitHub CLI 官方网站 · 厂商产品页面
- GitHub CLI 帮助 · 厂商支持
- GitHub CLI 手册 · 官方命令参考
- Foxhole 进程图谱 · Windows PC 上的第一方采集样本。非实验室基准测试。
这篇文章有用吗？
回答"是"或"否"即可。如果您愿意，可以选择一个原因，或添加一段简短附言。
感谢。这有助于我们改进此页面。