一句话看懂:GitHub 异步合并 API 已正式可用(GA),把合并 PR 从“一次请求等到底”改成“提交后轮询查状态”,并成为官方推荐的编程式合并路径。
事件核心:发生了什么
据 GitHub Changelog 2026 年 10 月 1 日消息,GitHub 异步合并 API 结束预览、正式开放。它能合并单个或堆叠式(stacked)拉取请求,也能把 PR 加入合并队列,或直接合并;如果你有相应权限,还可以选择绕过合并规则。
调用方式分两步:先用 PUT 提交合并请求,拿到请求 ID,再用 GET 轮询该 ID 查询状态。这意味着长耗时、冲突复杂的合并不再卡住整条自动化流水线,机器人可以“提交完就走”。
为什么重要
对大型代码仓库和 CI/CD 自动化来说,合并往往是同步接口里最不稳定的环节——仓库越忙,请求超时和重试越频繁。异步化把“等待结果”和“发起动作”拆开,自动化脚本的容错和吞吐都会更好。
更关键的是定位变化:GitHub 明确把异步合并 API 列为推荐的编程式合并方式,取代此前的同步 REST 端点和 GraphQL mutation。它也是目前唯一支持堆叠 PR 的合并 API。堆叠 PR 在大型团队和 AI 代码生成工作流里越来越常见,这条支持会直接影响工具链的选型。
对用户/开发者/创作者的影响
开发者侧,建议把现有的同步合并脚本迁移到“PUT 提交 + GET 轮询”模式,尤其是有合并队列或受保护分支规则的仓库。轮询需要注意退避策略和超时上限,避免高频请求触发限流。
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
做代码托管、代码评审、AI 编程助手类产品的团队,可以把异步合并作为默认集成路径,减少长请求带来的失败率;对于生成大量 PR 的 AI Agent,异步接口更适配“批量提交、后台等待”的工作流。普通用户在网页端的操作方式不变,变化主要发生在自动化层。
值得关注的后续
1)同步 REST 端点与 GraphQL mutation 是否进入弃用周期,给出明确迁移时间表;2)合并队列在多仓库、大规模并发下的稳定性表现,是否成为新的默认推荐;3)绕过分支规则的能力如何与权限、审计日志配合,企业合规场景是否出现新的管控要求。


