Wrangler 安装方式

Cloudflare 项目中，建议优先把 wrangler 作为项目本地开发依赖安装，而不是将全局安装作为团队标准。

官方文档：https://developers.cloudflare.com/workers/wrangler/install-and-update/

npm install -D wrangler

在 package.json 中通过 scripts 统一调用：

{
  "scripts": {
    "dev": "wrangler dev",
    "deploy": "wrangler deploy",
    "types": "wrangler types"
  }
}

使用方式：

npm run dev
npm run deploy

也可以不定义脚本，直接使用项目本地版本：

npx wrangler deploy

为什么推荐本地安装#

• 版本受 package.json 和 lockfile 锁定，开发机、CI 和团队成员保持一致。
• 避免全局 Wrangler 自动升级后，与项目配置、构建行为或插件产生兼容性差异。
• CI 可使用 npm ci && npm run deploy，部署环境可复现。

全局安装的适用场景#

全局安装更适合个人临时操作，例如快速初始化项目、检查账户状态或一次性执行 CLI 命令：

npm install -g wrangler

即使全局安装了 Wrangler，正式项目的开发和部署仍应优先用 npm run 或 npx 调用项目本地版本。