1. [Wiki](https://feex.it/wiki/)
2. [软件](https://feex.it/wiki/software/)
3. [效率](https://feex.it/wiki/software/productivity/)
4. GitHub CLI

# GitHub CLI

应用程序: GitHub

也称为 gh、gh cli、hub cli

GitHub, 效率

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

Feex 表示

如果系统提示无法识别 gh，我会从 cli.github.com 安装 GitHub CLI。我不会先去修复 GitHub Desktop。Desktop 是图形界面，而这是 gh.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。

## 它有什么用？

**拉取请求与议题 (Issues)**

gh pr create 和 gh issue。Desktop 可以通过鼠标点击实现这些操作。单靠 git.exe 无法免去额外步骤直接创建 GitHub PR。

**gh auth login**

通过设备代码或浏览器登录 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 软件包即为此产品。

## 版本

以主要渠道为主。此处并未对所有确切的版本号进行逐一验证。

gh MSI 安装包

## 系统要求

数值遵循发布者的公开指引。实际需求仍会因工作负载而异。

### 最低配置

| 操作系统 | 根据 GitHub CLI 的说明，需要当前受支持的 64 位 Windows 10 或 Windows 11 版本 |
| ---- | ---------------------------------------------------------- |
| 内存   | 该命令行工具体积微小                                                 |

## 资源占用概况

- **CPU 需求**: 跟随您在应用内打开的内容

  **内存需求**: 跟随文档、标签页或库

## 安装的进程

这些可执行文件属于该产品安装后的组件。

| gh.exe | GitHub CLI |
| ------ | ---------- |

## 启动项组件

gh.exe 不会随 Windows 启动。你需要在终端中运行它。

## 文件位置

| 典型安装 | C:\Program Files\GitHub CLI\\ |
| ---- | ----------------------------- |

## 文件格式

\--json 标志返回的 JSON 数据

## 常见问题

### 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/ ](https://cli.github.com/)官方安装程序或厂商页面                     |
| ---- | -------------------------------------------------------------------------- |
| 帮助   | [cli.github.com/manual/ ](https://cli.github.com/manual/)厂商支持              |
| 官方网站 | [cli.github.com/ ](https://cli.github.com/)请从此处开始，而非随意的 exe 托管网站           |
| 手册   | [cli.github.com/manual/ ](https://cli.github.com/manual/)gh pr、gh repo 与认证 |

## 相关硬件

该命令行工具极其小巧。连接 GitHub 的网络环境通常是唯一的性能瓶颈。

## 技术细节

技术细节

厂商版本号会发生变动。本文不锁定特定内部版本。

## 相关内容

这些实体与本文相关联。每个链接上均显示类型。

[GitHub Desktop: 应用程序](https://feex.it/wiki/l/zh-hans/software/github-desktop/)[如何看懂任务管理器: 指南](https://feex.it/wiki/l/zh-hans/software/system/how-to-read-task-manager/)

## 来源与验证

记录的来源标签：August 2026。此标签并不代表已完成独立验证。 [我们的研究方式](https://feex.it/wiki/research/).

- [GitHub CLI 官方网站 ](https://cli.github.com/)· 厂商产品页面
- [GitHub CLI 帮助 ](https://cli.github.com/manual/)· 厂商支持
- [GitHub CLI 手册 ](https://cli.github.com/manual/)· 官方命令参考
- [Foxhole 进程图谱 ](https://foxhole.feex.it/)· Windows PC 上的第一方采集样本。非实验室基准测试。

## 这篇文章有用吗？

回答"是"或"否"即可。如果您愿意，可以选择一个原因，或添加一段简短附言。

速览

本页面的简要身份信息。详细规格、来源和完整内容保留在正文中。

- **开发者**: GitHub

  **类别**: GitHub 命令行工具

  **进程**: gh.exe

  **许可证**: MIT

  **首次发布时间**: 2020

  **官方网站**: [cli.github.com](https://cli.github.com/)

  **由 Feex 映射**: 在 Foxhole 的 Windows PC 上捕获

记录的来源状态：Feex 已审核: 记录的来源标签：August 2026。此标签并不代表已完成独立验证。

---

Source: [Canonical Feex Wiki page](https://feex.it/wiki/l/zh-hans/software/github-cli/)

[Developer guide](https://feex.it/wiki/developers/) | [API policy](https://feex.it/developers/api-policy/) | [Agent guidance](https://feex.it/wiki/llms.txt)