Cloudflare Workers 环境搭建
这一篇把本地开发环境搭起来，包括 Node.js、Wrangler CLI 和账号授权登录。环境就绪后，后面所有章节都在这套环境里操作。
Wrangler 是什么
Wrangler 是 Cloudflare 官方发布的命令行工具，负责 Workers 开发的所有环节
| 功能 | 对应命令 |
|---|---|
| 创建项目 | npm create cloudflare@latest |
| 本地运行 | wrangler dev |
| 线上部署 | wrangler deploy |
| 登录授权 | wrangler login |
| 查看日志 | wrangler tail |
| 管理密钥 | wrangler secret put |
| 管理 KV | wrangler kv namespace create |
| 管理 D1 | wrangler d1 create |
它本质上是一个 npm 全局包，安装后可以在任何目录调用。
安装 Node.js
Wrangler 依赖 Node.js 运行，要求 18 以上版本，推荐使用 LTS 版本（如 20.x）。安装方法可以参考本站的 Node.js 环境搭建，Windows 用户直接下载官方安装包即可。
安装完成后在终端验证
node -v
# 输出类似 v20.12.0
npm -v
# 输出类似 10.5.0安装 Wrangler
推荐全局安装，这样任何目录都能直接使用
npm install -g wrangler如果国内网络安装慢，先配置 npm 镜像源再安装，方法同样参考 Node.js 环境搭建。
也可以不全局安装，用 npx wrangler 临时调用，每次都会检查并下载最新版，缺点是每次执行都稍慢。全局安装更顺手，本教程后续统一用全局方式。
验证安装
wrangler --version
# 输出类似 4.x.x登录 Cloudflare 账号
本地工具需要取得操作你账号的权限，执行授权登录
wrangler login命令会自动打开浏览器，跳转到 Cloudflare 登录页，同意授权后浏览器会提示成功，终端也会显示登录完成。
验证当前登录身份
wrangler whoami输出会显示你的邮箱和所属账号名称，说明登录成功。如果之前没注册账号，登录流程里可以直接注册，和上一篇的注册是同一个账号体系。
仪表盘与命令行的互补关系
两套工具各有所长，完整开发流程中会交替使用
| 环节 | 推荐工具 |
|---|---|
| 写代码调试 | 命令行 Wrangler |
| 部署发布 | 命令行 Wrangler |
| 看用量统计 | 仪表盘 |
| 绑定自定义域名 | 仪表盘 |
| 查看版本回滚 | 仪表盘或命令行 |
| 应急改代码 | 仪表盘在线编辑器 |
最简单的原则是”代码靠命令行，配置靠仪表盘”。写完代码用命令部署，部署后去仪表盘管理路由、域名和用量。
环境检查清单
搭完环境后，运行下面三条命令确认全部就绪
node -v
wrangler --version
wrangler whoami都正常输出即代表环境搭建完成。下一篇用命令行创建项目，正式进入本地开发工作流。