GitHub Cli gh指令操作

GitHub CLI（gh）是 GitHub 官方出品的命令行工具，让你不用打开浏览器就能完成绝大多数 GitHub 操作——创建仓库、提交 PR、管理 Issue、查看 CI 运行结果等，全部在终端搞定。它的核心价值在于：用 gh auth login 一次浏览器授权替代了以前繁琐的 SSH 密钥配置，同时把 GitHub 的工作流无缝嵌入到你的终端开发流程中。对于需要向开源项目提交代码、管理多个仓库、或者在服务器上自动化 GitHub 操作的开发者来说，gh 是一个值得上手的效率工具。

gh 指令：

bash
展开代码
gh auth status                    # 查看当前登录状态
gh repo list --limit 20           # 列出自己的仓库
gh pr create \
  --repo modelscope/ms-swift \        # 目标上游仓库
  --head xxddccaa:feat/xxx \          # 来源：fork用户:分支名
  --base main \                       # 目标分支
  --title 'PR标题' \
  --body '正文内容'                    # 创建 PR

下面是我整理的 gh 常用场景速查：

安装

Ubuntu / Debian

bash
展开代码
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \
  | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/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

CentOS / RHEL / Fedora

bash
展开代码
sudo dnf install 'dnf-command(config-manager)'
sudo dnf config-manager --add-repo https://cli.github.com/packages/rpm/gh-cli.repo
sudo dnf install gh

macOS

bash
展开代码
brew install gh

验证安装

bash
展开代码
gh --version

仓库操作

bash
展开代码
# 列出自己的仓库
gh repo list
gh repo list --limit 50

# 创建新仓库
gh repo create my-repo --public
gh repo create my-repo --private --description "描述"

# Clone 仓库（自动处理认证）
gh repo clone owner/repo

# Fork 一个仓库
gh repo fork owner/repo
gh repo fork owner/repo --clone   # fork 并立即 clone 到本地

# 查看仓库信息
gh repo view owner/repo
gh repo view owner/repo --web     # 在浏览器打开

Issue 操作

bash
展开代码
# 列出 issue
gh issue list
gh issue list --repo owner/repo
gh issue list --state closed
gh issue list --label bug

# 创建 issue
gh issue create --title "Bug标题" --body "描述"

# 查看某个 issue
gh issue view 123
gh issue view 123 --web

# 关闭 / 重开 issue
gh issue close 123
gh issue reopen 123

# 给自己分配 issue
gh issue edit 123 --add-assignee @me

PR 操作

bash
展开代码
# 列出 PR
gh pr list
gh pr list --repo owner/repo
gh pr list --state merged

# 创建 PR（当前分支 → 默认主分支）
gh pr create
gh pr create --title "标题" --body "描述"
gh pr create --draft                   # 草稿 PR

# 向上游 fork 提交 PR（fork 场景）
gh pr create \
  --repo upstream-owner/repo \
  --head your-username:your-branch \
  --base main \
  --title "标题" \
  --body "描述"

# 查看 PR
gh pr view 123
gh pr view 123 --web

# checkout 到某个 PR 的分支（review 用）
gh pr checkout 123

# 合并 PR
gh pr merge 123
gh pr merge 123 --squash
gh pr merge 123 --rebase

# 关闭 PR
gh pr close 123

CI / Workflow 操作

bash
展开代码
# 查看 workflow 运行列表
gh run list

# 查看某次运行的详情和日志
gh run view 1234567
gh run view 1234567 --log

# 手动触发 workflow
gh workflow run ci.yml

# 查看所有 workflow
gh workflow list

Release 操作

bash
展开代码
# 列出 release
gh release list

# 创建 release
gh release create v1.0.0
gh release create v1.0.0 --title "v1.0.0" --notes "更新内容"

# 上传附件到 release
gh release upload v1.0.0 ./dist/app.tar.gz

# 下载 release 的附件
gh release download v1.0.0

其他实用指令

bash
展开代码
# 在浏览器打开当前仓库
gh browse

# 查看通知
gh notification list

# 搜索仓库
gh search repos "关键词" --limit 10

# 用 gh 直接调用 GitHub API（高级用法）
gh api repos/owner/repo
gh api repos/owner/repo/pulls --jq '.[].title'

目录