跳转到内容

术语表

Workers 的文档里有几个词特别容易被混用,先统一一下口径。

Worker 指你写的那个 fetch 处理函数本体,而 wrangler 是操作它的命令行工具。名字像,但一个是运行时的东西,一个是本地 CLI。

绑定(binding)wrangler.jsonc 里给某个资源起的名字,代码里通过 env.<名字> 访问它。同一个 KV namespace 可以被多个 Worker 用不同绑定名引用。

兼容性日期(compatibility_date 决定平台用哪一套行为跑你的代码——很多语义变更(比如某个全局对象是否存在、某个 API 的默认值)都按这个日期开关。新项目直接填当天,老项目升级时不要顺手改它,那等于一次性引入一批行为变更。

区域 / colo 指处理某个请求的具体边缘机房。你无法指定用户落到哪个 colo,所以任何依赖“请求都在同一台机器上处理”的写法都是错的——需要这种语义请用 Durable Objects。

实例(isolated context) 是平台跑你代码的沙箱。它可以被复用,也可能在两次请求之间被冻结再丢弃,所以:

  • 模块顶层的变量在实例复用期间存活,但不保证存活
  • 别把内存当数据库用
  • 定时器、长循环要放进 waitUntil 或改成队列消费者

路由(route) 决定哪些 URL 进你的 Worker,写在 routes 里;不配路由时 Worker 只有 *.workers.dev 那个默认域名。自定义域名则是把一个真实域名挂到 Worker 上,DNS 记录要在你账号里托管。