技能介绍

要解决的常见问题

Cloudflare Wrangler CLI 命令繁多，开发者容易凭记忆写错 flag，或混淆 wrangler.jsonc 的配置字段、binding 形态，导致初始化、部署或资源管理失败，且部署前缺乏统一的校验逻辑。

技能如何工作

该技能是 Cloudflare Wrangler（Workers CLI，v4.x+）的使用与排障专家，核心能力是先确保语法、配置字段、binding 形态正确，避免凭记忆出错。优先以官方文档 https://developers.cloudflare.com/workers/wrangler/ 与本地 node_modules/wrangler/config-schema.json 为准。

关键步骤包括：

确认已安装 Wrangler v4.x+，若版本过低则通过 npm install -D wrangler@latest 升级
优先使用 wrangler.jsonc 配置文件，将 compatibility_date 设为近 30 天内日期
配置变更后生成类型，CI 中使用 wrangler types --check 校验
本地开发用 wrangler dev，需连接真实资源时在 binding 中加 remote: true
部署前通过 wrangler deploy --dry-run 做演练校验
密钥使用交互式 wrangler secret put KEY 或文件输入，绝不在命令行参数/echo 中传递密钥值
排障时可使用 wrangler whoami、wrangler check startup、wrangler tail --status error

适用边界

支持 Worker 初始化、开发、部署，管理 KV、R2、D1、Vectorize 等多种资源，编写/校验 wrangler.jsonc，密钥管理、版本回滚、日志观测、本地 Vitest 测试等场景。不适用于纯前端构建（非 Cloudflare 平台）的框架 CLI 场景，以及需要 SDK 编程调用的场景，不会臆造文档中不存在的 flag。

截图预览

使用场景

初始化并部署带 R2 与 AI binding 的 Worker，需要正确的 wrangler.jsonc 配置与部署步骤
用 wrangler dev 本地调试 Worker，需要连接真实的 KV 或 D1 资源而非本地模拟存储
在 CI 中用 wrangler types --check 校验 wrangler.jsonc 变更，避免 binding 字段写错导致构建失败
排查 Worker 启动超时问题，需要借助 wrangler check startup 与 wrangler tail 定位原因

适合人员

独立开发者：自己发布 Worker 到 Cloudflare，需要确认 wrangler.jsonc 的 binding 与 compatibility_date 写法
运维工程师：负责 CI 流水线，需要 wrangler types --check 与 dry-run 校验来保证部署安全
后端工程师：使用 KV、D1 等存储，需要在本地与远端 binding 之间切换调试
安全工程师：管理 Worker 密钥，需要安全的 wrangler secret 操作方式而非命令行传值