素材阁

GitHub CLI 速查

共 28 条 GitHub CLI(gh)命令,覆盖登录与仓库、Pull Request、Issue、Actions 与发布、 其他五组场景。支持搜索与分类筛选,点击即可复制。

登录与仓库

首次使用先 gh auth login。

命令说明
交互式登录(浏览器 / Token)
查看登录状态与账号
克隆仓库
创建仓库(--private 私有)
在浏览器打开当前仓库
Fork 并按需克隆
列出某用户的仓库

Pull Request

PR 的创建、查看与合并。

命令说明
创建 PR(--fill 用提交信息自动填充)
列出 PR
查看 PR 详情 / 浏览器打开
把某 PR 检出到本地分支
查看 PR 的改动差异
查看 PR 的 CI 检查状态
合并 PR(--merge / --rebase 可选)

Issue

问题单的创建与处理。

命令说明
创建 Issue
按标签列出 Issue
查看 Issue 详情
关闭 Issue
添加评论

Actions 与发布

工作流与 Release。

命令说明
列出工作流运行记录
实时查看当前运行进度
查看某次运行的日志
手动触发工作流
创建 Release 并自动生成说明

其他

Gist 与直接调 API。

命令说明
创建 Gist
直接调用 GitHub REST API
调用 GraphQL API
设置 gh 使用的编辑器

使用说明

GitHub CLI 速查:登录与仓库、Pull Request、Issue、Actions 与发布、其他;支持搜索与分类筛选,点击即可复制。

  1. 按用途点分类:登录与仓库、Pull Request、Issue、Actions 与发布、其他。
  2. 点「命令」列复制,替换仓库、编号与分支后执行。
  3. 首次使用先 gh auth login;日常提交 PR 用 gh pr create --fill。
  4. 看 CI 状态用 gh pr checks / gh run watch。

常见问题

gh 和 git 是什么关系?
git 是通用版本控制命令;gh 是 GitHub 官方 CLI,把仓库 / PR / Issue / Actions 等 GitHub 操作搬到命令行,底层仍走 git 与 GitHub API,两者配合使用。
怎么克隆别人的仓库并贡献?
gh repo fork owner/repo --clone 会 fork 并克隆;改完推送后 gh pr create --fill 直接创建 PR,全程不必打开浏览器。
gh pr checkout 是做什么的?
它把某个 PR 的分支检出到本地,方便你 review、本地跑测试或在其基础上继续改,无需手动配置远程。
gh api 有什么用?
当 gh 子命令没覆盖某功能时,可直接调 GitHub REST/GraphQL API,例如 gh api repos/{owner}/{repo},是能力最全的兜底方式。

延伸阅读

相关工具