Wrangler 说明文档

# Cloudflare Wrangler Cloudflare Workers 的官方 CLI，用于从命令行开发、管理和部署 Workers。 ## 什么是 Wrangler？ Wrangler 是 Cloudflare 开发者平台 CLI，允许你： - 创建、开发和部署 Workers - 管理绑定（KV, D1, R2, Durable Objects 等） - 配置路由和环境 - 运行本地开发服务器 - 执行迁移并管理资源 - 执行集成测试 ## 安装 bash npm install wrangler --save-dev # 或全局安装 npm install -g wrangler 运行命令：`npx wrangler ` (或 `pnpm`/`yarn wrangler`) ## 阅读顺序 | 如果你想... | 从这里开始 | |-------------------|------------| | 快速创建/部署 Worker | 下方的“基础命令” → [patterns.md](./patterns.md) §New Worker | | 配置绑定 (KV, D1, R2) | [configuration.md](./configuration.md) §Bindings | | 编写集成测试 | [api.md](./api.md) §startWorker | | 调试生产问题 | [gotchas.md](./gotchas.md) + 基础命令 §Monitoring | | 设置多环境工作流 | [configuration.md](./configuration.md) §Environments | ## 基础命令 ### 项目与开发 bash wrangler init [name] # 创建新项目 wrangler dev # 本地开发服务器（快速，模拟环境） wrangler dev --remote # 使用远程资源开发（类生产环境） wrangler deploy # 部署到生产环境 wrangler deploy --env staging # 部署到指定环境 wrangler versions list # 列出版本 wrangler rollback [id] # 回滚部署 wrangler login # OAuth 登录 wrangler whoami # 检查认证状态 ## 资源管理 ### KV bash wrangler kv namespace create NAME wrangler kv key put "key" "value" --namespace-id= wrangler kv key get "key" --namespace-id= ### D1 bash wrangler d1 create NAME wrangler d1 execute NAME --command "SQL" wrangler d1 migrations create NAME "description" wrangler d1 migrations apply NAME ### R2 bash wrangler r2 bucket create NAME wrangler r2 object put BUCKET/key --file path wrangler r2 object get BUCKET/key ### 其他资源 bash wrangler queues create NAME wrangler vectorize create NAME --dimensions N --metric cosine wrangler hyperdrive create NAME --connection-string "..." wrangler workflows create NAME wrangler constellation create NAME wrangler pages project create NAME wrangler pages d