Wrangler Cloudflare Workers 边缘部署 CLI

边缘函数部署的痛点

把 Cloudflare Workers 推上线并不是难点，难点在于本地编写与线上运行之间那条割裂的链路。开发者通常要维护两套环境配置：本地模拟器自己搭，线上部署脚本自己写，KV、R2、D1 等存储的绑定参数在两边各写一份，改了线上忘了本地是常态。Wrangler 要解决的正是这个问题：它把构建、测试、部署收敛到一个 CLI，用同一份 wrangler.toml 描述环境。

核心能力与工作方式

Wrangler 的开发体验围绕三个环节展开：

• 本地开发：通过 Miniflare 在本地模拟 Workers 运行时，wrangler dev 启动后可以直接看到代码改动的热更新效果，不必等每次 push。
• 资源绑定：在 wrangler.toml 中声明 kv、r2、d1 等绑定，本地与线上指向同名资源，省去手工同步环境变量的步骤。
• 零配置部署：wrangler deploy 将 bundle 推到 Cloudflare 全球网络，没有独立的服务器或容器要维护，冷启动成本由平台承担。

一个典型的工作流是：写好 handler → wrangler dev 本地验证 → 确认绑定行为 → wrangler deploy 上线。

适用边界

• Workers 适合请求驱动的轻量计算，长时间批处理或 CPU 密集任务不在它的定位内。
• wrangler.toml 的绑定配置需要线上资源提前创建好，CLI 不会自动申请 KV namespace。
• 本地 Miniflare 与线上运行时存在细微差异，涉及特定绑定行为时仍需以线上为准。