sitdraw

如何安装并使用 GitHub CLI（gh）：登录、克隆仓库与从终端开 PR

按官方步骤安装 GitHub CLI，完成 gh auth login，并从终端克隆仓库或创建 Pull Request。

要在终端用 GitHub CLI（命令 gh）克隆仓库或开 Pull Request，先完成三件事：按官方方式安装，跑 gh auth login，再执行 gh repo clone 或 gh pr create。

按官方安装页与手册走，不要猜包名。核心检索词是 如何安装 GitHub CLI、gh auth login，以及 用 gh 开 PR。文档在 cli.github.com 与 cli.github.com/manual/。

gh官方命令名
auth先登录再调 API
PR终端里创建请求

先按系统装官方二进制

macOS 与 Windows

macOS：brew install gh。Windows：winget install --id GitHub.cli，也可用 Scoop 或 Chocolatey。装完跑 gh --version。

Linux

Debian / Ubuntu / Fedora 等请跟 cli.github.com 上的发行版仓库，不要随便拷贝第三方 deb。企业机若禁 Homebrew，用官方发布页的包。

步骤命令要注意
登录gh auth login选 github.com 或 Enterprise；HTTPS 或 SSH；浏览器或 token
检查gh auth status确认账号、协议、token 是否仍有效
克隆gh repo clone owner/repo私有库需要对应权限；SSO 组织要额外授权
开 PRgh pr create分支须已推远程；可用 --fill 或手写标题正文

安装、登录、克隆或开 PR

  1. 01
    安装并确认版本

    按官方页选包管理器。装完 gh --version 应打印版本号。若命令找不到，检查 PATH，不要和旧的第三方 gh 脚本混用。

  2. 02
    跑 gh auth login

    选 GitHub.com（或管理员给的 Enterprise 主机）。协议：日常 HTTPS 即可；已用 SSH 密钥就选 SSH。有浏览器选 Login with a web browser，记下一次性码，到 github.com/login/device 粘贴。无图形界面粘贴 PAT。

  3. 03
    克隆一个仓库

    在目标目录执行 gh repo clone owner/repo。成功后目录里应有 .git。只读失败时看 gh auth status 与组织 SSO。

  4. 04
    从当前分支创建 PR

    改完代码、提交并推送后，在仓库根目录跑 gh pr create。按提示填 title/body，或 gh pr create --fill。浏览器里打开返回的 URL 核对 diff。

gh --version
gh auth login
gh auth status
gh repo clone owner/repo
cd repo
# 提交并推送当前分支后：
gh pr create --title "Fix login timeout" --body "Repro and fix."
必须用浏览器登录吗？
不必。官方向导支持粘贴 personal access token。CI 或无头机器用 token 或 GH_TOKEN 环境变量，不要写进仓库。
HTTPS 和 SSH 怎么选？
已有 GitHub SSH 密钥并加到账号，选 SSH，后续 git 操作走同一密钥。否则选 HTTPS，gh 会帮你配凭据助手。
pr create 说找不到仓库或拒绝？
确认当前目录是 git 仓库、远程指向 GitHub、分支已 push，且账号对该 repo 有写权限。SSO 组织要在授权页启用该 org。
装完就能当白板用吗？
不能。这是 GitHub 的终端客户端。要对着同一张图说话时，再开 sitdraw。

先登录，再动仓库

没跑通 gh auth status 之前，不要把失败的 clone 当成网络问题。多数是账号、SSO 或协议没配对。

开始画