wrangler

用途

Wrangler 是 Cloudflare Workers 的官方 CLI，用于部署、开发和管理 Cloudflare Workers 及其关联资源。官方要求使用 v4.x 及以上版本，可通过 wrangler --version 检查；若未安装，使用 npm install -D wrangler@latest。

主要能力

Wrangler 覆盖 Workers 全流程管理与资源操作，包括：

• Workers 的开发、部署、删除、日志与版本回滚
• KV 命名空间与键值管理
• R2 对象存储的桶与对象管理
• D1 SQL 数据库、迁移、SQL 执行与导出备份
• Vectorize 向量索引与向量插入、查询
• Hyperdrive 数据库加速配置管理
• Workers AI 模型与微调列表
• Queues 队列与消费者管理
• Containers 镜像构建、推送与容器管理
• Workflows 工作流与实例管理
• Pipelines 数据管道管理
• Secrets Store 密钥库管理
• Pages 前端项目创建与部署
• 可观测性：wrangler tail 实时日志

使用方式

核心命令包括：

• 本地开发：wrangler dev
• 部署：wrangler deploy（支持 --dry-run 预览、--env 指定环境、--minify、--keep-vars）
• 生成 TypeScript 类型：wrangler types（支持自定义输出路径与 --check）
• 校验配置：wrangler check
• 查看实时日志：wrangler tail
• 认证状态：wrangler whoami

配置推荐使用 wrangler.jsonc，并设置 compatibility_date。示例最小配置：

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "name": "my-worker",
  "main": "src/index.ts",
  "compatibility_date": "2026-01-01"
}

绑定配置支持 KV、R2、D1、AI、Vectorize、Hyperdrive、Durable Objects、Cron 触发器与环境（env.staging / env.production）。本地开发默认使用本地存储模拟，可通过 remote: true 连接真实资源（如 AI 必须远程）。本地密钥使用 .dev.vars 文件。

测试方面，可搭配 @cloudflare/vitest-pool-workers 与 Vitest 进行本地测试，并通过 wrangler dev --test-scheduled 测试定时事件。

适用场景

适用于需要构建、部署和运维 Cloudflare Workers 及配套云资源的开发者，尤其是使用 Workers 全家桶（KV、R2、D1、Queues、Workflows、Containers 等）进行应用开发、需要本地开发与远程资源结合、需要版本回滚与日志观测、以及需要在前端使用 Cloudflare Pages 部署的场景。

限制

官方资料中未提供具体的收费、价格或平台限制说明。Workers AI 在本地开发时也始终远程运行并产生使用费用（官方说明如此）。其余未提及的功能、价格或平台信息暂未提供。