概览
EdgeOne Pages 提供内置的持久化存储能力，可在 Pages Functions 中直接使用，无需额外搭建后端或对接第三方服务。
目前支持两种存储类型：
KV — 分布式键值存储，适合存放配置、计数器、Session 等单点状态。
Blob — 分布式对象存储，适合存放图片、文档、用户上传文件、AI 生成内容等非结构化数据，支持目录层级。
如何选择
简单判断：存几个小键值用 KV；存对象、需要目录层级或较大数据用 Blob。
特性 | KV 存储 | Blob 存储 |
定位 | 分布式变量 | 分布式对象集合 |
数据组织 | 扁平 key → value | 按 / 路径组织，支持目录层级 |
单值上限 | 25 MB | 25 MB |
运行环境 | 仅 Edge Functions | Edge Functions / Cloud Functions |
接入方式 | 控制台开通 → 创建命名空间 → 绑定项目 | getStore('name') 即用即得，无需配置 |
一致性 | 60s 最终一致 | 60s 最终一致 |
适合 KV 的场景
访问计数器、点击统计、限流计数
Feature Flag（功能开关）、AB 实验配置
用户 Session、登录态
API 密钥等敏感配置
适合 Blob 的场景
用户上传的图片、附件、文档
AI 生成的图片、文档、报告
按目录组织的结构化数据集（多个 JSON、批量记录等）
需要写入后立即读到最新值的场景
快速对比
// KV：通过绑定变量名访问await my_kv.put("visitCount", "1");const count = await my_kv.get("visitCount");
// Blob：通过 SDK 直接使用import { getStore } from "@tencent/pages-blob";const store = getStore("uploads");await store.set("photos/cat.jpg", imageData);const file = await store.get("photos/cat.jpg");
