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 可直接生成晨会清单,让分流动作有数据依据。