快速开始

Cloudflare Workers 让你把 JavaScript / TypeScript 函数部署到边缘网络。你不接触机器，按请求数计费，改一行代码重新部署即可生效。

第一次上手最容易踩的坑不是代码，而是运行时 API 的名字和绑定没建。下面按顺序走完就没事。

装 wrangler

全局装或者用 npx 都可以：

npm install --global wrangler@latest

npx wrangler@latest --version

建项目并跑起来

脚手架一个新 Worker：
终端窗口
```
npm create cloudflare@latest my-worker
```
选 “Hello World App”，包管理器随你。
进到目录里起本地服务：
终端窗口
```
npx wrangler dev
```
默认在 http://127.0.0.1:8787 监听。注意这跑的是真 workerd，不是 Node 起的模拟服务器。
打开 src/index.ts，改一下返回的字符串，浏览器刷新——改动会热加载，不用重启。

部署

npx wrangler deploy

输出里会给你 https://<worker-name>.<你的子域>.workers.dev 这个地址，以及每个绑定的解析结果。

加一个存储绑定

以 KV 为例，三步：声明、创建、回填 id。

{
  "name": "my-worker",
  "kv_namespaces": [
    { "binding": "MY_KV", "id": "<把创建出来的 id 填这里>" }
  ]
}

npx wrangler kv namespace create MY_KV

import { env } from 'cloudflare:workers';

export default {
  async fetch() {
    await env.MY_KV.put('greeting', 'hello from the edge');
    const value = await env.MY_KV.get('greeting');
    return Response.json({ value });
  },
} satisfies ExportedHandler<Env>;

下一步

去 CLI 参考看全部命令，或者查 wrangler.jsonc 配置项。想知道某个名词指什么，翻术语表。