生活分享

Cloudflare 开源 Forge：一套可自动生成 SDK、CLI 与文档的生成流程

Cloudflare 于 2026 年 9 月 28 日宣布推出开源生成流程 Forge，可从 API 规范自动生成 SDK、命令行工具与文档。本文介绍 Forge 的用途和设计思路，以及它对开发者和 Cloudflare 现有用户可能带来的影响。

阅读时间约 6 分钟

Cloudflare 开源 Forge：一套可自动生成 SDK、CLI 与文档的生成流程
图片：Mokaair (Original editorial artwork)

Cloudflare 宣布了什么

Cloudflare 于 2026 年 9 月 28 日在官方博客发表文章，宣布推出 Forge。文章由 Dimitri Mitropoulos、Matt “TK” Taylor 与 Samuel Macleod 撰写。据 Cloudflare 介绍，Forge 是一个开源、可插拔（可按需加入或替换各个生成模块）的生成流程。它可用于生成 SDK（软件开发工具包）、CLI（命令行工具）、文档与库，任何人都可以免费部署和运行。

Cloudflare 表示，Forge 仍处于早期阶段，但已用于生成 cf CLI 所需的输出，并将在未来几个月内支持 Cloudflare 的 API 文档、SDK 等。Cloudflare 还说明，开发 Forge 是为了把 AI 代理（agents）当作客户来服务。在它看来，CLI、API SDK、MCP 服务器及相应文档如今已是每种产品的标配。MCP 服务器是让 AI 代理能够调用外部工具和服务的接口。

Cloudflare 开源 Forge：一套可自动生成 SDK、CLI 与文档的生成流程
Mokaair 编辑核查流程 · 图片：Mokaair (Original editorial artwork)
阅读完整文字说明

消息会先收集来源、独立核查，再交由 Jev 判断。

Cloudflare 为什么要自己打造 Forge

据 Cloudflare 介绍，其 API 有超过 3,500 个操作，背后数百个服务以 Rust、Go、TypeScript、Python 等多种语言编写。Cloudflare 表示，它曾试用若干托管产品，并在生产环境中依赖过其中一些，但均未能解决问题，部分产品甚至已完全停止服务。过去曾发生这样的情况：某个团队合并的变更意外破坏了生成流程，另一个团队直到发布时才发现。

Cloudflare 表示，Forge 在 CI（持续集成，即每次提交代码时自动运行的检查流程）中运行，覆盖各团队的 API 代码仓库。它会检查每个变更，并生成可安装测试的 CLI、文档与 SDK 预览版本，只突出显示本次变更的内容，让问题在影响下游之前被发现。

依据 Cloudflare 官方博客整理，内容为 Cloudflare 单方说法
方面Cloudflare 描述的过去情况Cloudflare 描述的 Forge 做法
发现问题的时机变更可能在发布时才被另一团队发现在 CI 中对每个变更进行检查并生成预览
工具控制权依赖无法掌控的托管工具，部分已停止服务开源、可自行免费部署运行
输入格式文章未详述目前支持 OpenAPI，设计上未来可支持 AsyncAPI、GraphQL、Cap’n Proto、Protobuf 等
输出之间的关系其他生成器通常由工具决定串联方式转换器可串联，由用户自行控制

Forge 的主要设计特点

可生成多种输出，包括 Cap’n Web

Cloudflare 表示，Forge 可从 OpenAPI 规范直接生成 Cap’n Web。OpenAPI 是一种描述 API 如何调用的通用标准格式。Cap’n Web 是 Cloudflare 的 RPC（远程过程调用）系统，让 TypeScript 能像调用本地方法一样调用远程 API。Cloudflare 举例指出，同样的方式也可用于生成 TanStack Query 绑定、Zod 或 Valibot 模式（schema）、MCP 服务器等。

转换器可以串联

在 Forge 中，转换器是负责生成某种输出的组件。据 Cloudflare 介绍，一个转换器的输出可以用来生成其他输出，串联方式由用户自行控制。Cloudflare 以 cf CLI 为例：它用 TypeScript 编写，除了自动生成的部分，还包含 cf dev、cf build 等手写添加的命令，这些命令需要调用 Vite 等包的 TypeScript API。Cloudflare 表示找不到能把这类手写命令反馈到文档中的现有工具，因此正把这项功能构建进 Forge。

与 API 版本管理的关系

据 Cloudflare 介绍，其 v4 API 已是 10 年来唯一的主要版本。Cloudflare 表示，正在研究一种版本管理方式，让未来发布新的主要 API 版本时不会破坏旧的客户端或 SDK。Cloudflare 还表示，很快会公布更多关于 TypeScript、Rust、Python、Go、PHP 与 Terraform SDK 的消息，并会对 Terraform 的过渡格外谨慎。Terraform 是一种用代码管理云端基础设施的工具。

对普通读者与开发者的实际影响

  • 对普通用户：这类工具主要在幕后运作。若 Cloudflare 所述目标实现，其 CLI、SDK 与文档有望更一致地跟上 API 变更，但这取决于后续实际成果。
  • 对开发者：Cloudflare 表示 Forge 开源且可免费部署，理论上可用于为自家 API 生成 SDK、CLI 与文档；由于仍处于早期阶段，评估前宜留意其成熟度。
  • 对 AI 代理生态：Cloudflare 将 MCP 服务器等接口视为标配，这反映出 API 提供方正在思考如何让 AI 代理更方便地使用其服务。
  • 对 Cloudflare 现有用户：Cloudflare 提到将调整 API 版本管理与 SDK，包括 Terraform，后续公告值得关注。

常见问题

Forge 是什么？

据 Cloudflare 介绍，Forge 是一个开源、可插拔的生成流程，用于从 API 规范生成 SDK、CLI、文档与库，任何人都可以免费部署和运行。

Forge 现在已经在实际使用了吗？

Cloudflare 表示 Forge 仍处于早期阶段，但已用于生成 cf CLI 所需的输出，并将在未来几个月内支持 Cloudflare 的 API 文档与 SDK。

Forge 支持哪些输入格式？

据 Cloudflare 介绍，Forge 目前支持 OpenAPI，设计上未来可支持 AsyncAPI、GraphQL、Cap’n Proto、Protobuf 等其他输入格式。

Cloudflare 为什么不继续使用现有的托管工具？

Cloudflare 表示，曾试用并依赖若干托管产品，但均未能满足其跨团队、跨数百个代码仓库的需求，部分产品甚至已停止服务。

这会影响我目前使用的 Cloudflare API 或 Terraform 配置吗？

Cloudflare 表示正在研究一种方式，让新的主要版本发布时不会破坏旧的客户端或 SDK，并将对 Terraform 的过渡格外谨慎。具体细节尚未公布，建议关注 Cloudflare 后续官方公告。

Forge 的相关说法经过独立验证了吗？

没有。本文信息仅来自 Cloudflare 官方博客，属于该公司自身的说法。

查看同分类最新消息

同主题延伸阅读

最新旅游情报攻略

资料来源

生活分享