Workers 说明文档

# Cloudflare Workers 构建、部署与优化 Cloudflare Workers 应用的专家指南。 ## 概览 Cloudflare Workers 运行在 V8 隔离环境（非容器/虚拟机）： - 极快的冷启动 (< 1ms) - 全球 300 多个节点部署 - 符合 Web 标准 (fetch, URL, Headers, Request, Response) - 支持 JS/TS, Python, Rust 和 WebAssembly **核心原则**：Workers 尽可能使用 Web 平台 API 以实现可移植性。 ## 模块化 Worker 模式（推荐） typescript export default { async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise { return new Response('Hello World!'); }, }; **处理程序参数**： - `request`: 传入的 HTTP 请求（标准 Request 对象） - `env`: 环境绑定（KV, D1, R2, 密钥, 变量） - `ctx`: 执行上下文 (`waitUntil`, `passThroughOnException`) ## 必备命令 bash npx wrangler dev # 本地开发 npx wrangler dev --remote # 远程开发（使用实际资源） npx wrangler deploy # 生产部署 npx wrangler deploy --env staging # 特定环境部署 npx wrangler tail # 流式日志 npx wrangler secret put API_KEY # 设置密钥 ## 何时使用 Workers - 边缘 API 端点 - 请求/响应转换 - 认证/授权层 - 静态资源优化 - A/B 测试与功能开关 - 速率限制与安全 - 代理/路由逻辑 - WebSocket 应用 ## 快速开始 bash npm create cloudflare@latest my-worker -- --type hello-world cd my-worker npx wrangler dev ## 处理程序签名 typescript // HTTP 请求 async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise // 定时任务 (Cron triggers) async scheduled(event: ScheduledEvent, env: Env, ctx: ExecutionContext): Promise // 队列消费者 async queue(batch: MessageBatch, env: Env, ctx: ExecutionContext): Promise // 日志追踪消费者 async tail(events: TraceItem[], env: Env, ctx: ExecutionContext): Promise ## 资源 **文档**: https://developers.cloudflare.com/workers/ **示例**: https://developers.cloudflare.com/workers/examples/ **运行时 API**: https://developers.cloudflare.com/workers/runtime-apis/ ## 本参考内容 - [配置](./configuration.md) - wrangler.jsonc 设置、绑定、环境 - [API](./api.md) - 运行时 API、绑定、执行上下文 - [模式](./patterns.md) - 常见工作流、t