全局 flag
这些 flag 放在子命令后面即可，例如 npx wrangler deploy --config ./prod.jsonc。
| flag | 作用 | 备注 |
|---|---|---|
--config |
指定配置文件路径 | 多环境时用它切换，见下 |
--env / -e |
选择 env.* 段 |
与 --config 二选一即可 |
--var KEY:value |
注入一个变量 | 值不敏感时才用；命令行会进 shell history |
--define KEY=value |
构建期常量替换 | 打包时就固定，不能运行时改 |
--inspect |
开 Node 调试器端口 | 排查只有堆栈的报错 |
--local |
操作本地资源 | D1/KV 的本地状态在 .wrangler/state |
--remote |
操作账号里的真实资源 | 与 --local 互斥，忘了切是高频事故 |
--legacy-env |
用旧的 name-env 命名 |
新项目不要加 |
-y / --yes |
跳过确认 | CI 里配合非交互 shell 使用 |
-l debug |
提高日志级别 | 报 “Invalid JSON in response” 之类先看这个 |
npx wrangler deploy --config wrangler.production.jsonc环境变量形式的凭据
Section titled “环境变量形式的凭据”wrangler 会读这几个环境变量，优先级高于本地 OAuth token：
| 变量 | 用途 |
|---|---|
CLOUDFLARE_API_TOKEN |
身份凭据 |
CLOUDFLARE_ACCOUNT_ID |
目标账号；不填则从 token 推断 |
CLOUDFLARE_CACHE_LIST / WRANGLER_LOG |
调试用，WRANGLER_LOG=debug 输出详细日志 |
wrangler 失败时返回非 0，可以直接在脚本里判断：
npx wrangler deploy || { echo "deploy failed"; exit 1; }