用途:规范 Cloudflare Wrangler CLI 的命令用法、配置与部署安全。代码审查归属 workers-best-practices,平台选型归属软件 PaaS 托管技能;完整命令语法以 wrangler <cmd> --help 和 Cloudflare 文档为准。
主要能力分参考模块:入门(安装/版本/核心命令)、配置(wrangler.jsonc、绑定、环境、生成类型)、本地开发与部署(dev 模式、远程绑定、dry run、密钥、回滚)、存储与数据(KV、R2、D1)、平台服务(Vectorize、Hyperdrive、Workers AI、Queues、Containers、Workflows、Pipelines、Secrets Store)、Pages/日志/测试/排障。
使用方式:先确认 Wrangler 版本或项目依赖,再查阅当前 Cloudflare 文档或本地 node_modules/wrangler/config-schema.json;优先使用 wrangler.jsonc,绑定或配置改动后运行 wrangler types,部署前用 wrangler deploy --dry-run 或最安全的项目检查。生产前需核对账户、Worker/Pages 项目、环境、数据库或命名空间绑定与路由;部署后确认返回的版本或部署标识。使用 wrangler versions upload 再 wrangler versions deploy 进行分阶段发布。密钥用 wrangler secret put,禁止回显。
选型判断:需要持久本地文件系统、原生二进制或完整 Linux 进程模型应使用 Containers;超出请求 CPU 或内存预算考虑 Containers、Queues 或外部批处理;AI 与平台服务(Hyperdrive、Workers AI 等)需查阅专题文档。DO 按用户/租户/房间分片,SQLite 存储为新类默认并需迁移条目。
限制:资料未给出具体价格、配额与延迟数字,需查官方文档。新项目建议用带静态资源的 Worker,Pages 兼容性以迁移指南为准。