Qiniu/technical/mac-dev-env-setup/gh-cli-commands.md

tags, create time

tags	create time
github cli dev-env	2026-07-01 00:00

GitHub CLI (gh) 命令速查

概述

gh 是 GitHub 官方 CLI，在终端完成 PR、Issue、Fork、Clone 等操作，比浏览器更流畅。它与 Git + Claude Code 组合可以形成完整的高效开发工作流。

安装

# macOS
brew install gh

# 验证
gh --version
gh auth login   # 首次运行，按提示登录 GitHub 账号

Pull Request 操作

查看与筛选

gh pr list                      # 当前仓库的 open PR（最近 30 条）
gh pr list --state closed       # 已关闭的 PR
gh pr list --assignee your-user # 分配给自己的 PR

gh pr status                    # 自己相关的 PR：当前分支 / 创建过 / 需要你 review

Checkout 到本地

gh pr checkout 12               # 通过 PR 编号 checkout（自动处理 fork）
gh pr checkout patch-2          # 通过分支名 checkout
gh pr view 12                   # 终端内查看 PR 详情
gh pr view 12 --web             # 浏览器打开 PR

创建 PR

gh pr create                    # 交互式创建
gh pr create --title "feat: add xxx" --body "description"
gh pr create --web              # 浏览器打开创建页

Issue 操作

gh issue list                   # 列出 open issues
gh issue list --label bug       # 按标签过滤
gh issue list --assignee user   # 按负责人过滤

gh issue status                 # 与你相关的 issues（分配/提及/自己开的）

gh issue view 42                # 终端查看 issue 详情
gh issue view 42 --web          # 浏览器打开

gh issue create                 # 交互式创建
gh issue create --label bug --title "fix: xxx"

Repository 操作

Clone

gh repo clone owner/repo        # OWNER/REPO 语法
gh repo clone https://github.com/owner/repo   # URL 语法

Fork

# 在已有仓库目录中
gh repo fork                    # 自动 fork + 询问是否添加 remote

# 跳过 remote 提示
gh repo fork --remote=false

# Fork 后跳过克隆
gh repo fork owner/repo --clone=false

# Fork 时直接克隆
gh repo fork owner/repo         # 会自动问是否 clone

View

gh repo view owner/repo         # 终端查看仓库信息 + README
gh repo view owner/repo --web   # 浏览器打开
gh repo view                  # 当前所在仓库

常见工作流示例

Fork → 开发 → 提 PR

gh repo fork owner/repo           # 1. Fork
cd repo                             #    进入目录
git checkout -b feature/new-ui      # 2. 创建功能分支
# ... 编码 ...
git commit -m "feat: new ui"
git push origin feature/new-ui      # 3. 推送
gh pr create --title "feat: new UI components" \
            --body "Closes #42"     # 4. 创建 PR

Review 别人提交的 PR

gh pr checkout 8896               # 1. Checkout 别人的 PR
git pull origin patch-2           #    确保最新
# ... 审查代码 ...

Claude Code + gh 协作

gh issue list                     # 1. 查看任务列表
gh issue view 42                  #    查看具体需求
claude                            # 2. AI 助手直接在当前分支实现

参考链接

• GitHub 官方文档: https://cli.github.com/
• mac-dev-env-setup — macOS 开发环境配置总指南
• mac-dev-env-setup/ai-coding-agent — AI Coding Agent 安全边界与提示策略