用途:Wrangler 是 Cloudflare Workers 的命令行工具,覆盖本地开发、部署与资源管理。安装需 v4.x+,可用 npm install -D wrangler@latest,用 wrangler --version 验证。
主要能力:核心命令包括 wrangler dev(本地开发,默认使用本地存储模拟)、wrangler deploy(部署)、wrangler types(生成 TypeScript 类型)、wrangler check(校验配置)、wrangler tail(查看实时日志)、wrangler delete、wrangler whoami。资源管理覆盖 KV、R2、D1、Vectorize、Hyperdrive、Workers AI、Queues、Containers、Workflows、Pipelines、Secrets Store,以及 Pages 部署。
使用方式:配置优先使用 wrangler.jsonc,需设置 compatibility_date(建议 30 天内)并可在变更后运行 wrangler types。绑定资源时可用 remote: true 让本地开发连接真实资源;本地密钥放在 .dev.vars。部署前可用 wrangler deploy --dry-run 校验。测试可用 @cloudflare/vitest-pool-workers,配合 wrangler dev --test-scheduled 与 /__scheduled 端点测试 cron。
适用场景:Workers 应用的开发、部署、资源绑定、环境区分(env.staging/env.production)、密钥管理与日志观测。
限制:Workers AI 始终远程运行并产生用量费用,本地开发也不例外;部分事实如具体价格、配额与完整命令列表资料未提供。