用途:面向 Cloudflare Workers KV 的知识技能,用于在 Cloudflare 边缘网络上使用全局、低延迟的键值存储,适合创建 KV 命名空间、配置绑定并编写读写逻辑。依赖 cloudflare-worker-base 进行 Worker 设置,资料标注状态为 Production Ready,最新版本为 wrangler@4.43.0、@cloudflare/workers-types@4.20251014.0。
主要能力:提供完整 Workers KV API 说明,包括 get() 单键与批量读取(支持 text、json、arrayBuffer、stream 类型及 cacheTtl)、getWithMetadata() 读取元数据、put() 写入(支持 expirationTtl、expiration、metadata)、list() 列表(支持 prefix、limit、cursor 分页,键按 UTF-8 字典序返回)、delete() 删除。还介绍缓存模式、元数据优化、键合并、分页辅助、功能开关等模式,以及 Wrangler CLI 的命名空间创建、键值读写、列表、删除和批量操作。
使用方式:通过 npx wrangler kv namespace create MY_NAMESPACE 创建命名空间,在 wrangler.jsonc 或 wrangler.toml 中配置 kv_namespaces 的 binding、id、preview_id,代码中通过 env.MY_NAMESPACE 访问。本地开发用 npm run dev,可用 curl 测试端点。CLI 支持 npx wrangler kv key put/get/list/delete 及 bulk put/delete。
适用场景:读多写少(约 100:1)、无需强一致性的配置、功能开关、缓存、用户偏好、会话数据等。
限制:键最大 512 字节,值最大 25 MiB,元数据最大 1024 字节,单键写入速率最大 1 次/秒,过期最小 60 秒;批量读取仅支持 text 和 json;REST API 批量删除每次最多 10,000 键;KV 为最终一致性,跨区域更新约 60 秒内可见,不适合金融交易、强一致性或高频写同一键的场景,强一致需使用 Durable Objects。资料未提供收费与价格信息。