Ubuntu 或 Debian 系列的 WSL 中，建議使用官方的套件庫進行安裝。
安裝步驟
你可以依序執行下列指令來完成安裝。這會下載 GitHub 的官方金鑰並將套件來源加入你的清單中。
type -p curl >/dev/null || (sudo apt update && sudo apt install curl -y)
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install gh -y驗證安裝
安裝完成後，請輸入指令確認版本。
gh --version如果畫面正確顯示版本資訊，代表安裝成功。
登入帳號
在使用 gh 建立 release 之前，你必須先進行授權，否則會因為權限不足被拒絕。請執行以下指令並依照畫面提示操作。
gh auth login通常建議選擇透過瀏覽器 (web browser) 登入，它會跳出一個視窗要求你輸入 GitHub 帳號密碼，或是給你一組 code 貼上。
排除路徑問題
如果你確定已經安裝過，但 zsh 仍然找不到，可以嘗試執行 source ~/.zshrc 重新讀取設定檔。如果是透過 Linuxbrew 安裝的，請檢查 /home/linuxbrew/.linuxbrew/bin 是否在你的 PATH 變數中。你可以輸入 echo $PATH 來檢查目前的環境變數路徑。
在 Windows 上安裝 GitHub CLI (gh) 有幾種常見且快速的方法。根據你是否有使用套件管理員，可以選擇最適合你的方式。
使用 Winget 安裝
這是 Windows 10 與 11 內建的推薦方式，不需要額外下載安裝檔，直接在 PowerShell 或命令提示字元 (CMD) 執行即可。
winget install --id GitHub.cli使用 Scoop 安裝
如果你有在使用 Scoop 這個套件管理工具，可以用以下指令安裝。Scoop 通常會處理好所有路徑設定，對開發者非常友善。
scoop install gh使用 Chocolatey 安裝
如果你習慣使用 Chocolatey，請執行。
choco install gh使用安裝程式 (MSI)
如果你偏好傳統的點擊安裝方式，可以依照以下步驟操作。
- 前往 GitHub CLI 的官方 Release 頁面。
- 下載檔名結尾為 .msi 的檔案 (例如 gh_2.x.x_windows_amd64.msi)。
- 執行該檔案並一路點擊下一步直到完成。
驗證與登入
安裝完成後，請務必重新啟動你的終端機 (PowerShell、CMD 或 Windows Terminal)，然後執行指令檢查。
gh --version確認能讀取到版本後，執行登入指令。
gh auth login依照畫面提示選擇 GitHub.com，並使用瀏覽器進行授權即可完成設定。如果你之後要在 WSL 裡面使用，記得 WSL 與 Windows 的環境是分開的，需要在 WSL 內再安裝一次。