用途:Mergify Merge Queue 将 PR 合并串行化,在临时合并提交上运行 CI,在进入目标分支前捕获集成失败。
主要能力:通过 PR 评论入队/出队(@mergifyio queue、@mergifyio dequeue;@mergifyio requeue 为已弃用别名,等同 queue)。CLI 提供 mergify queue status(批次、等待 PR、暂停状态,支持 --branch、--json)、mergify queue show <PR_NUMBER>(PR 在队列中的详细状态,-v 显示完整检查表与条件树,--json 输出机器可读结果)、mergify queue pause --reason "..." 与 mergify queue unpause。queue show 可判断 PR 是在队列中、已出队、已被队列合并还是从未入队,并给出出队代码、原因与失败检查的 job 日志链接。
使用方式:入队/出队由 PR 评论驱动,Mergify 处理后会加 👍 反应确认。入队后用 mergify queue show <PR_NUMBER> 跟踪状态。诊断出队时优先用 queue show;若因权限(403)降级,可改用活动日志 API(GET /v1/repos/{owner}/{repo}/logs,需 MERGIFY_TOKEN,received_from 必填且窗口不超过 93 天)、Mergify Merge Queue 检查运行或 # Merge Queue Status 评论。
适用场景:需要保证目标分支 CI 通过后再合并的仓库;排查 PR 为何被移出队列、CI 失败原因及后续处理。
限制:活动日志仅保留 90 天,更早的出队会显示为无活动;queue show 不校验 PR 是否存在,编号错误会得到同样的“不在合并队列中”提示;检查运行与状态评论可能因推送或仓库配置而缺失,不能据此断定从未入队。部分出队代码(如 PR_AHEAD_DEQUEUED 等)只是中断检查,PR 仍在队列中,不应重新入队。