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 負責建立 Pull Request 並與 GitHub API 進行通訊。git.exe 仍然是版本控制系統。GitHub Desktop 則是圖形介面。您可以在沒有 gh 的情況下使用 git。但您無法在每次本機提交時用 gh 取代 git。

## 它有什麼用途？

**Pull Request 與 Issue**

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 目前提供的 github 命令列工具。原廠仍引導 Windows 使用者前往 https://cli.github.com/。

## 它的歷史有多久？

GitHub 在早期的 hub 工具之後，於 2020 年正式發布 gh 作為官方支援的 CLI。它比 GitHub Desktop (2015) 更新，更遠比 Git (2005) 年輕。目前 Windows 的 MSI 與 winget 套件即是此產品。

## 版本

主要管道優先。確切的版本號在此並未全部經過驗證。

gh MSI

## 系統需求

數值遵循發行者的公開指引。實際需求仍會隨工作負載而改變。

### 最低需求

| 作業系統      | 根據 GitHub CLI 說明，需使用目前受支援的 64 位元 Windows 10 或 Windows 11 版本 |
| --------- | ----------------------------------------------------------- |
| 記憶體 (RAM) | 此 CLI 極為輕巧                                                  |

## 資源概況

- **CPU 需求**: 跟隨您在應用程式內開啟的內容

  **RAM 需求**: 跟隨文件、分頁或資料庫

## 已安裝的處理程序

安裝本產品後，這些可執行檔即歸屬於本產品。

| 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 與驗證 |

## 相關硬體

此 CLI 極為輕量。通往 GitHub 的網路連線通常是唯一的瓶頸。

## 技術詳細資訊

技術詳細資訊

廠商版本號碼會變更。本文未限定特定組建。

## 相關項目

這些實體與本文連結。每個連結上都會顯示類型。

[GitHub Desktop: 應用程式](https://feex.it/wiki/l/zh-hant/software/github-desktop/)[如何解讀工作管理員: 指南](https://feex.it/wiki/l/zh-hant/software/system/how-to-read-task-manager/)

## 來源與驗證

記錄的來源標籤：2026年8月。此標籤不代表獨立驗證。 [我們的研究方式](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 電腦的第一手樣本。非實驗室基準測試。

## 這篇文章實用嗎？

只要回答「是」或「否」即可。您也可以依意願選擇原因，或附上簡短說明。

速覽

本頁面的簡短身分識別。規格、來源和完整說明保留在文章中。

- **開發者**: GitHub

  **類別**: GitHub 命令列

  **處理序**: gh.exe

  **授權**: MIT

  **首次發布**: 2020

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

  **由 Feex 繪製圖譜**: 於 Foxhole 中的 Windows 電腦上發現

記錄的來源狀態：Feex 已審核: 記錄的來源標籤：2026年8月。此標籤不代表獨立驗證。

---

Source: [Canonical Feex Wiki page](https://feex.it/wiki/l/zh-hant/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)