用途:面向使用 Cloudflare Workers 构建应用的开发者,提供 TypeScript 项目初始化、配置、处理器编写与微服务通信的基础模式。
主要能力:
- 项目初始化:npm create cloudflare@latest my-worker 或 wrangler init my-worker。
- 处理器模式:HTTP fetch 处理器、scheduled 定时处理器(cron)、queue 队列消费者处理器。
- 配置:使用 wrangler.jsonc(非 wrangler.toml),设置 compatibility_date、compatibility_flags(如 nodejs_compat)、observability、vars 及 KV、R2、D1、Durable Objects、Queues 等绑定。
- 类型生成:npx wrangler types 从配置和 .dev.vars 自动生成 Env 接口,可指定输出路径或包含运行时类型。
- 密钥管理:本地用 .dev.vars,生产用 wrangler secret put/list/delete 或仪表盘;支持账户级 Secret Store。
- Service Bindings:通过 WorkerEntrypoint 导出 RPC 类,实现 Worker 间零延迟、类型安全的调用,也支持基于 fetch 的绑定。
- 后台任务:使用 ctx.waitUntil 处理非关键工作;错误处理返回合适 HTTP 状态码。
使用方式:按文档初始化项目,编写 ES 模块格式的 TypeScript 代码,配置 wrangler.jsonc,运行 wrangler types 生成类型,部署前设置密钥。
适用场景:构建 API、微服务架构、定时任务、队列消费及需要 Worker 间通信的应用。
限制:仅支持 ES 模块格式,不支持 Service Worker 格式;不支持原生绑定(FFI/C);密钥不得写入 wrangler.jsonc;资料未提供收费、价格或平台细节。