跳至內容

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 一起啟動。您是在終端機中執行它。

檔案位置

常見 GitHub CLI 位置
典型安裝路徑 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/ 官方安裝程式或廠商頁面
說明 cli.github.com/manual/ 廠商支援
官方網站 cli.github.com/ 請從此處開始，而非隨機的 exe 託管網站
手冊 cli.github.com/manual/ gh pr、gh repo 與驗證

相關硬體

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

技術詳細資訊

技術詳細資訊

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

來源與驗證

記錄的來源標籤：2026年8月。此標籤不代表獨立驗證。 我們的研究方式.

這篇文章實用嗎？

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

這篇文章實用嗎？