Wrangler 是 Cloudflare Workers 的官方命令行工具，用于开发、部署和管理 Workers 及其相关资源。
【用途】 Wrangler 覆盖 Workers 项目的完整生命周期：初始化项目、本地开发、预览、部署、密钥管理、版本回滚、日志观察，以及对 KV、R2、D1、Vectorize、Hyperdrive、Workers AI、Containers、Queues、Workflows、Pipelines、Secrets Store、Pages 等 Cloudflare 资源的命令行管理。
【环境与安装】 需要 Wrangler v4.x 及以上版本，可用 wrangler --version 检查。未安装时执行 npm install -D wrangler@latest。
【配置】 推荐使用 wrangler.jsonc（JSON 配置优于 TOML，较新功能仅支持 JSON）。应设置较新的 compatibility_date（30 天内），可使用 compatibility_flags（如 nodejs_compat_v2）。配置变更后运行 wrangler types 生成或更新 TypeScript 绑定；部署前运行 wrangler check 提前发现错误。可通过 env.staging、env.production 区分环境。最小配置包含 $schema、name、main、compatibility_date。
【本地开发】 wrangler dev 启动本地开发服务器，默认使用本地存储模拟绑定；--env 指定环境，--local 强制仅本地，--remote 为远程边缘模式（legacy），--port 指定端口，--live-reload 支持 HTML 热重载，--test-scheduled 可测试定时/ cron 处理器。本地密钥使用 .dev.vars 文件。可在绑定配置中使用 remote: true 在本地运行时连接真实资源，推荐用于 AI（必须）、Vectorize、Browser Rendering、mTLS、Images。
【部署与密钥】 wrangler deploy 部署到生产，--env 指定环境，--dry-run 仅校验不部署，--keep-vars 保留控制台设置的变量，--minify 压缩代码。密钥通过 wrangler secret put/list/delete/bulk 管理，支持交互式、标准输入、JSON 批量写入。版本管理提供 wrangler versions list/view 和 wrangler rollback（可指定版本 ID）。
【资源管理】 KV：namespace create/list/delete、key put/get/list/delete、bulk put，支持 expiration-ttl。 R2：bucket create/list/info/delete（支持 location 提示）、object put/get/delete。 D1：database create/list/info/delete、execute（--remote/--local、--command/--file）、migrations create/list/apply、export 备份（可 --no-data 仅导出结构）。 Vectorize：create（--dimensions/--metric 或 --preset）、list/get/delete、insert（NDJSON）、query（--top-k）。 Hyperdrive：create/list/get/update/delete，需 nodejs_compat_v2。 Workers AI：wrangler ai models、ai finetune list；注意 AI 始终远程运行，即使本地开发也会产生用量费用。 Queues：create/list/delete、consumer add/remove，配置 max_batch_size、max_batch_timeout。 Containers：build（-t、--push）、push、list/info/delete、images list/delete、registries list/configure/delete。 Workflows：list/describe/trigger（--params）/delete，以及实例 list/describe/terminate。 Pipelines：create（--r2）、list/show/update/delete。 Secrets Store：store create/list/delete 与 secret put/list/get/delete。 Pages：project create、deploy（--branch）、deployment list。
【观察与测试】 wrangler tail 实时流式日志，可指定 Worker、--status 过滤状态、--search 搜索、--format json。配置 observability（enabled、head_sampling_rate）控制日志。测试可使用 @cloudflare/vitest-pool-workers 与 vitest 做本地测试，通过 --test-scheduled 和访问 /__scheduled 触发定时事件。
【适用场景】 适用于在 Cloudflare 边缘平台上构建、调试和发布 Workers 及无服务器资源的开发者，覆盖从本地开发、CI 校验到生产部署与运维的流程。
【限制与注意】 需 v4.x+；较新功能仅支持 JSON 配置；compatibility_date 需保持较新；Workers AI 始终远程运行并计费；本地默认使用本地存储模拟，远程绑定需显式设置 remote: true；常见问题（命令未找到、认证错误、配置校验失败、类型错误、本地存储未持久化、绑定未定义）有对应排查方式。定价、具体平台支持范围等资料未提供。