在 Cloudflare Workers 中,要使用命令行 (CLI) 将 KV (Key-Value) 命名空间绑定到你的 Worker

以下步骤演示如何通过命令行工具 <code>wrangler</code> 将 KV 命名空间绑定到你的 Worker。

  1. 配置 <code>wrangler.toml</code>
    在项目根目录下的 <code>wrangler.toml</code> 文件中,添加 <code>kv_namespaces</code> 配置项:

name = "my-worker"
main = "src/index.js"
compatibility_date = "2024-01-01"

[[kv_namespaces]]
binding = "MY_KV_NAMESPACE" # Worker 中访问的变量名(通过 env.MY_KV_NAMESPACE 使用)
id = "your-kv-namespace-id" # 在 Cloudflare Dashboard 的 KV 页面获取

  • binding:代码中引用的名称,例如 env.MY_KV_NAMESPACE。
  • id:KV 命名空间的唯一 ID,可在控制台复制。
  1. 登录 Cloudflare 账号
    执行以下命令,浏览器将打开登录页面:

wrangler login

  1. 部署 Worker
    运行部署命令,wrangler 会自动读取配置并绑定 KV:

wrangler deploy

  1. 验证 KV 是否生效(可选)
    部署后,可通过 curl 测试 Worker 接口,例如:

curl https://your-worker.dev/your-path

具体地址取决于你的 Worker 路由和代码逻辑。

提示:如需绑定多个 KV,可继续添加 [[kv_namespaces]] 块,每个块分别指定 binding 和 id。