首页/开发/Git 与协作速查/用 gh 批量巡检与分流 PR
协作与代码评审75 条

用 gh 批量巡检与分流 PR

命令行按作者、标签、状态过滤 PR,输出列表或 JSON,把「谁在等评审、哪些被阻塞」变成一次查询。

Git 与协作速查开发更新于 2026-10-13

gh pr list 巡检是什么

gh pr list 在终端按作者、标签、状态、目标分支等条件过滤 PR,输出表格或 JSON,把「谁在等评审、哪些被阻塞、我的待办是什么」变成一条命令;GitLab 侧对应 glab mr list。它是每日巡检、分流与自动化的第一入口:表格给人看,JSON 给机器处理,同一套过滤条件两用。

基本信息

常用过滤--author、--label、--search、--state、--base
输出默认表格;--json 输出结构化数据供脚本处理
分页--limit 控制条数,脚本里显式设置,避免只看到默认几行
搜索语法--search 'review-requested:@me' 与网页搜索一致
配套命令gh pr status 看自己的总览;glab mr list 处理 GitLab 侧同类需求

典型使用场景

  • 每日巡检:一条命令列出所有等待评审的 PR。
  • 个人待办:--search 'review-requested:@me' 看我被请求评审的。
  • 标签分流:--label needs-review 集中处理某一类。
  • 阻塞排查:搜索带 blocked 标签的打开项,找出卡住的并跟进。
  • 脚本集成:--json 输出喂给统计脚本或通知机器人,生成日报。
  • 发布前检查:列出目标为发布分支的打开 PR,核对是否都有结论。
  • 跨仓巡检:在多仓目录循环执行,得到统一清单。

常用示例

常用示例
gh pr list --state open --limit 50                       # 全部打开的 PR
gh pr list --search 'review-requested:@me'               # 轮到我评审的
gh pr list --label needs-review --json number,title,author
gh pr status                                             # 自己的 PR 总览
glab mr list --opened                                    # GitLab 侧对应命令

常用条件

条件含义例子
--author按作者过滤作者名或 @me
--label按标签过滤支持多个标签
--search复合搜索使用网页搜索语法,可组合多个条件
--base按目标分支过滤常用于 release 分支巡检
--limit条数上限脚本中要放大默认值
把常用查询写成别名或小脚本,每日巡检一分钟即可发现被忽略的 PR;--json 输出是接入自动化的关键,配合 jq 可直接生成晨会清单,让分流动作有数据依据。

易错点

  • search 语法与网页一致但字段受限,复杂条件用多次查询组合更稳,先单条件验证再逐步叠加,异常时便于定位。
  • 大量结果未分页时只显示默认数量;脚本里显式设置 --limit,并检查结果是否被截断,必要时把上限调大后在本地再过滤。
  • 只按标签巡检会漏掉没打标签的 PR;兜底查询 open 状态全量再分桶,每周核对一次标签覆盖率。
  • 多仓巡检忘记控制频率,触发平台 API 限流;错峰执行并复用查询结果,必要时退避重试,避免把访问令牌打爆。

数据来源与参考

  • GitHub CLI 手册:gh pr list
  • GitLab CLI 文档:glab mr list
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌