VSCode中NODE_ENV=xxx在Windows终端必然失败，因cmd/PowerShell不支持POSIX语法；必须用cross-env本地安装并配合tasks.json或launch.json正确配置。
VSCode 里直接写 NODE_ENV=production node app.js 在 Windows 上必然失败，这不是配置问题，是 cmd/PowerShell 语法根本不认这种写法。
为什么 VSCode 终端里 NODE_ENV=xxx 总是 undefined
VSCode 集成终端默认复用系统 Shell：Windows 是 cmd 或 PowerShell，Linux/macOS 是 bash/zsh。而 NODE_ENV=xxx 这种赋值语法只在 POSIX Shell（bash/zsh）中合法；cmd 会把它当做一个命令名去执行，PowerShell 则要求写成 $env:NODE_ENV="xxx"。VSCode 不做语法转换，也不自动注入——你看到的报错就是 Shell 层面的原生拒绝。
- cmd 报错：
'NODE_ENV=production' is not recognized as an internal or external command - PowerShell 报错：
The term 'NODE_ENV=production' is not recognized -
process.env.NODE_ENV始终为undefined，哪怕你在终端里手动set NODE_ENV=dev也只对当前命令生效，且不传给子进程
cross-env 必须本地安装，且不能全局装
全局安装的 cross-env 在 VSCode 里大概率找不到——尤其当你用 nvm 或 pnpm 管理 Node 版本时，集成终端的 PATH 和 VSCode 调试器的执行上下文可能根本没加载全局 bin 目录。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 正确安装：
npm install --save-dev cross-env（或yarn add -D cross-env） - Node.js 版本注意：
cross-env@7.x要求 Node ≥10；若项目还在用 Node 8，必须指定cross-env@6，否则启动时报Cannot use import statement outside a module - 别信“装一次全项目通用”——每个项目都得单独装，
node_modules/.bin/cross-env才能被 npm scripts 和 VSCode tasks 正确 resolve
launch.json 和 tasks.json 中怎么调用 cross-env
args 字段不是 Shell 命令行，它只是把字符串数组直接传给主进程，环境变量不会被解析。硬塞 "args": ["NODE_ENV=development", "node", "app.js"] 没用，Node.js 会把 NODE_ENV=development 当作第一个参数，而不是环境变量。
- 正确写法（
tasks.json）："command": "cross-env"，"args": ["NODE_ENV=development", "node", "app.js"] - 正确写法（
launch.json）："runtimeExecutable": "cross-env"，"runtimeArgs": ["NODE_ENV=test", "node"]，再配合"args": ["app.js"] - 绝对路径写法不可靠：
"runtimeExecutable": "/usr/local/bin/cross-env"或 Windows 下的C:\Users\x\AppData\Roaming\npm\cross-env.cmd会随机器、用户、包管理器变化而失效
别指望 .env 文件自动生效
VSCode 的 DotENV 插件只提供语法高亮，.env 文件本身对运行时零影响。require('dotenv').config() 也没法绕过 Shell 层——它只读文件，不接管进程启动时的环境。
- 调试时想用
.env：在launch.json里配"envFile": "${workspaceFolder}/.env"，但仅限 F5 启动，不影响终端npm run - 终端运行时想用
.env：得靠cross-env解析后注入，或自己写脚本读取并拼接cross-env VAR1=val1 VAR2=val2 node app.js -
require('dotenv').config()必须放在 JS 入口文件最顶部（ESM 下可用import 'dotenv/config'，但也得在其他import之前）
真正麻烦的不是装 cross-env，而是它必须和 launch.json、tasks.json、package.json 三处配置严格对齐——漏掉任意一处，process.env.NODE_ENV 就还是 undefined。跨平台一致性从来不是自动来的，是每处启动路径都显式声明出来的。
