用命令行巡检 PR
gh 是 GitHub 官方命令行工具，可以在终端里完成大部分 PR 巡检：gh pr status 汇总与自己相关的 PR 与检查状态，gh pr checks 看某条 PR 的检查结果，gh pr view 看单条详情。需要脚本化处理时，用 --json 指定字段输出结构化数据，再交给其他命令做汇总统计。相比在网页上逐个翻看，命令行更适合按固定节奏做例行巡检。
基本信息
| 常用命令 | gh pr status / gh pr list / gh pr view / gh pr checks |
|---|---|
| 结构化输出 | --json 指定字段名，字段可能缺失需兜底 |
| 过滤条件 | --author、--label、--search、--state |
| 权限要求 | 已通过 gh auth login 登录、令牌有仓库读取权限 |
| 适用平台 | GitHub 云端与企业版（企业版需指定主机名） |
典型使用场景
- 开工先看自己名下的 PR 有没有失败的检查或待回应的评审
- 请求评审前自查必需检查是否全绿，减少来回沟通
- 跨多个仓库批量巡检时用 --json 输出交给脚本汇总
- 检查失败时定位到具体检查名称与日志链接，直接跳转排查
- 交接班时用列表确认哪些 PR 卡在缺少审批
- 发版前核对目标分支上的 PR 是否都已完成检查与评审
常用示例
常用示例
gh pr status # 汇总自己相关的 PR 与检查状态
gh pr checks 128 # 查看指定 PR 的检查结果
gh pr checks 128 --watch # 持续刷新直到检查结束
gh pr list --author @me --state open # 列出自己尚未关闭的 PR
gh pr view 128 --json title,reviewDecision,mergeable # 结构化取关键字段
gh pr list --search 'review:required' # 按搜索语法筛选待评审的 PR常用子命令读法
| 子命令 | 作用 | 典型输出 |
|---|---|---|
| gh pr status | 汇总与自己相关的 PR | 待评审、已分配、我创建的 |
| gh pr checks | 检查项与结果 | 每项名称、状态、详情链接 |
| gh pr list | 按条件筛选 PR 列表 | 编号、标题、分支、标签 |
| gh pr view | 单条 PR 详情 | 描述、评审结论、可合并状态 |
CI 结果存在延迟，刚推送后 checks 可能仍显示旧状态，稍等片刻再确认，避免误判为失败或已通过。带 --watch 时命令会持续刷新到本轮检查结束，适合盯一次关键流水线。
脚本依赖 JSON 字段时要做兜底：没有评审或没有检查的 PR，相应字段会缺失或为空，直接取值会让解析中断。批量巡检前建议先在本机跑通一次字段解析。