用途:指导在 Cloudflare Workers 无服务器平台上构建 API、全栈应用与边缘函数,并连接 Cloudflare 存储与 AI 能力。
主要能力:文档涵盖运行时与处理程序(fetch、scheduled、queue、email)、绑定总览、Wrangler 配置、本地开发、静态资源与测试。绑定包括 KV、R2、D1、Durable Objects、Queues 均在本地模拟;Workers AI、Vectorize、Browser Rendering、Hyperdrive 仅支持远程;静态资源与服务绑定可本地模拟。项目推荐使用 ES Module 语法,导出默认对象与 fetch 等方法,通过 env 访问资源。
使用方式:常用命令为 npx wrangler dev(本地开发)、npx wrangler dev --remote(远程开发)、npx wrangler deploy、npx wrangler versions upload、npx wrangler versions deploy、npx wrangler secret put/list、npx wrangler types。配置使用 wrangler.jsonc 或 wrangler.toml,需设置 name、main、compatibility_date、compatibility_flags(如 nodejs_compat)、observability 等;定时任务用 [triggers] crons 配置。
限制与注意事项:不要把密钥写入 wrangler.toml,应使用 wrangler secret put;不要对 Durable Objects 或 Workflows 使用 remote: true;Workers AI 无法本地运行;不要省略 compatibility_date(默认最早日期 2021-11-02);新项目不要用 Service Worker 语法,也不要混用两种语法。常见问题:本地绑定为空需加 --local 标志;Node API 需加 nodejs_compat;首次部署应用 wrangler deploy 而非 versions upload。
适用场景:构建全球分发的无服务器 API、边缘函数、定时后台任务、队列异步处理、邮件路由及接入 Workers AI 推理。具体价格、配额等信息暂未提供。