C3 配置说明

# C3 生成的配置 ## 输出结构 my-app/ ├── src/index.ts # Worker 入口点 ├── wrangler.jsonc # Cloudflare 配置 ├── package.json # 脚本 ├── tsconfig.json └── .gitignore ## wrangler.jsonc c { "$schema": "https://raw.githubusercontent.com/cloudflare/workers-sdk/main/packages/wrangler/config-schema.json", "name": "my-app", "main": "src/index.ts", "compatibility_date": "2026-01-27" } ## 绑定占位符 C3 生成的 **占位符 ID** 必须在部署前替换： c { "kv_namespaces": [{ "binding": "MY_KV", "id": "placeholder_kv_id" }], "d1_databases": [{ "binding": "DB", "database_id": "00000000-..." }] } **替换为真实 ID：** bash npx wrangler kv namespace create MY_KV # 返回真实 ID npx wrangler d1 create my-database # 返回真实 database_id **未替换会导致部署错误：** Error: Invalid KV namespace ID "placeholder_kv_id" ## 脚本 { "scripts": { "dev": "wrangler dev", "deploy": "wrangler deploy", "cf-typegen": "wrangler types" } } ## 类型生成 添加绑定后运行： bash npm run cf-typegen 生成 `.wrangler/types/runtime.d.ts`： typescript interface Env { MY_KV: KVNamespace; DB: D1Database; } ## 创建后检查清单 1. 检查 `wrangler.jsonc` - 确认名称、compatibility_date 2. 将占位符绑定 ID 替换为真实资源 ID 3. 运行 `npm run cf-typegen` 4. 测试：`npm run dev` 5. 部署：`npm run deploy` 6. 添加密钥：`npx wrangler secret put SECRET_NAME`