如何安裝 GitHub CLI（gh）：auth login 登入、clone 倉庫與建立 Issue 和 Pull Request

安裝 gh，完成 auth login，clone 倉庫，並從命令列建立 Issue 與 PR。

在浏览器里点 GitHub 很快，但GitHub CLI（命令 gh）让你在终端完成登入、克隆仓库、开 Issue 和提 Pull Request，適合脚本与日常开发流。本教學涵蓋 macOS/Linux/Windows 安裝、gh auth login、gh repo clone、gh issue create 與 gh pr create，面向 hereink 讀者常用的 Git 與協作工作流。

檢索詞是如何安裝 GitHub CLI gh 並登入克隆倉庫建立 Issue 與 PR。讀完應能安裝 gh、完成 GitHub.com 認證、克隆一个仓库，并从命令行建立 Issue 与 Pull Request。

gh 解决什么问题

上游：github.com/cli/cli，文档 cli.github.com。安裝后运行 gh --version 确认。

安裝 GitHub CLI

1. 1
   macOS（Homebrew）

   brew install gh。驗證：which gh 与 gh --version。

2. 2
   Linux

   Debian/Ubuntu：按 cli.github.com 添加官方 apt 源后 sudo apt install gh。Fedora：sudo dnf install gh。通用 tarball 见官方 Releases。

3. 3
   Windows

   winget install GitHub.cli 或 choco install gh。新开 PowerShell 后 gh --version。

4. 4
   检查 PATH

   若命令找不到，确认安裝目录在 PATH 中；WSL 与 Windows 各装一份时，在你要用的 shell 里驗證。

gh auth login 登入 GitHub

首次使用前必须認證。在终端运行 gh auth login，按提示选择：

gh auth login
# 典型选择（GitHub.com 个人账号）：
# What account → GitHub.com
# Preferred protocol → HTTPS 或 SSH（与现有 git remote 一致即可）
# Authenticate → Login with a web browser（推荐）或 Paste an authentication token
# 浏览器完成 OAuth 后终端显示 ✓ Logged in

驗證：gh auth status 应显示已登入用户与 token 作用域。企業 GitHub Enterprise Server 需选对应 hostname，见官方 gh auth login 文档。

gh repo clone 克隆仓库

# HTTPS 或 SSH 由 auth 与 gh 配置决定
gh repo clone cli/cli
cd cli

# 指定目录名
gh repo clone owner/repo my-folder

# 浅克隆（大仓库）
gh repo clone owner/repo -- --depth=1

等价于 git clone，但可省略完整 URL：gh repo clone owner/repo 自动解析。私有仓库需已 gh auth login 且账号有读权限。

gh issue create 建立 Issue

cd your-repo   # 必须在 Git 仓库根或子目录，且 remote 指向 GitHub

gh issue create --title "Fix login timeout" --body "Steps to reproduce…"

# 交互式（编辑器填 body）
gh issue create

# 加标签与指派者
gh issue create --title "Docs: gh guide" --label documentation --assignee @me

列出与查看：gh issue list、gh issue view 123。在 fork 上操作时，确认 git remote -v 的默认仓库是你要开 Issue 的目标 repo。

gh pr create 建立 Pull Request

1. 1
   分支与推送

   git checkout -b fix-docs，改代码后 git commit，git push -u origin fix-docs（首次推送需 -u）。

2. 2
   建立 PR

   gh pr create --title "Fix docs" --body "Summary of changes"，或裸 gh pr create 走交互/编辑器。

3. 3
   常用选项

   --draft 草稿；--reviewer user1,user2；--base main 指定目标分支。查看：gh pr list、gh pr view、gh pr checkout 42。

gh 与纯 git 对照

適合

日常开发、开源贡献、自动化脚本、与 git、rg、HTTPie 同一终端栈。

不適合

仅本地 Git、无 GitHub remote 的仓库——装 gh 也无 API 可连；复杂 Code Review UI 仍常回浏览器。