用途:Wrangler 是 Cloudflare Workers 的命令行工具,用于开发、部署与管理 Worker,以及 KV、R2、D1、Vectorize、Hyperdrive、Workers AI、Containers、Queues、Workflows 等配套资源。文档强调:CLI 参数、配置字段与绑定结构可能变化,应优先检索官方文档与本地 config-schema.json,不要依赖旧知识。
安装与初始化:先执行 wrangler --version(需 v4.x+)确认是否安装;未安装则运行 npm install -D wrangler@latest。新建项目可用 npx wrangler init my-worker,或使用框架模板 npx create-cloudflare@latest my-app。
主要能力:本地开发用 wrangler dev;部署用 wrangler deploy,可加 --dry-run 预检、--env 指定环境、--minify 压缩;配置后运行 wrangler types 生成 TypeScript 绑定;wrangler check startup 分析启动耗时;wrangler tail 查看实时日志;wrangler versions 与 wrangler rollback 管理版本与回滚。
配置:推荐 wrangler.jsonc,包含 name、main、compatibility_date(建议较新日期)、compatibility_flags,以及 vars、kv_namespaces、r2_buckets、d1_databases、ai、vectorize、hyperdrive、durable_objects、triggers、env 等绑定。本地开发默认使用本地存储模拟,可通过绑定中的 remote: true 连接真实资源。本地密钥放在 .dev.vars,生产密钥用 wrangler secret put,禁止把密钥作为命令参数或写入日志。
适用场景:Workers 项目的开发、部署、数据与 AI 资源管理、队列与工作流编排、容器构建推送、Pages 前端部署及问题排查。
限制:Workers AI 始终远程运行并在本地开发时也可能产生用量费用;部分新特性仅支持 JSON 配置;密钥须避免明文传递。文档未提供固定收费价格与具体平台效果说明。