未设置 node_env 会导致 express、react ssr、lodash 等库默认启用开发模式逻辑，如禁用模板缓存、全量 proptypes 校验、保留调试元信息、常驻 hmr 监听器等，显著增加 cpu 和内存开销，引发卡顿。
没设 NODE_ENV 不会直接报错，但会让 Express、React（服务端渲染）、Lodash 等库默认走开发模式逻辑，CPU 和内存开销可能翻倍——尤其在调试或压测时明显卡顿。
为什么 NODE_ENV 未设置会导致性能损耗
很多主流库在运行时会检查 process.env.NODE_ENV 值，决定是否启用：
- Express 的模板引擎跳过缓存（view cache: false）
- React SSR 的 PropTypes 校验全量执行（非 production 下不 strip）
- Lodash 的防抖/节流函数保留调试元信息
- Webpack/Vite 的 HMR 监听器常驻、热更新路径全扫描
这些行为在调试中叠加，会显著拖慢单次请求响应、模块加载和断点命中速度。
如何快速确认 NODE_ENV 是否生效
别只看终端启动命令里有没有 export NODE_ENV=...，VSCode 调试器根本不会继承 shell 环境变量。必须验证它是否真正注入到 Node 进程里：
- 在代码入口顶部加一行：
console.log('NODE_ENV:', process.env.NODE_ENV); - 用 VSCode 启动调试（F5），观察控制台输出——如果打印
undefined或空字符串，说明没生效 - 不要依赖
npm start脚本里的cross-env：launch.json 会绕过 npm，直接调用 node
launch.json 中正确配置 env 的写法
必须显式写进每个 configuration 的 env 字段，且值为字符串（不是数字或布尔）：
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
{
"type": "node",
"request": "launch",
"name": "Launch Server",
"program": "${workspaceFolder}/src/app.js",
"env": {
"NODE_ENV": "development",
"DEBUG": "app:*"
}
}
常见错误：
-
"NODE_ENV": true→ Node.js 会转成字符串"true"，不是"production" -
"env": { "NODE_ENV": "${env:NODE_ENV}" }→ VSCode 不支持嵌套变量引用，该写法被忽略 - 只在某个 configuration 里配了
env，但你实际选的是另一个没配的 launch 配置 - 用了
attach模式却没在终端启动时带NODE_ENV=...，比如：NODE_ENV=production node --inspect-brk app.js
容易被忽略的隐性覆盖点
即使 launch.json 配了 NODE_ENV，也可能被以下方式悄悄覆盖：
- 项目根目录有
.env文件，且你装了dotenv—— 它会在require('dotenv').config()时重写process.env，覆盖 launch.json 的值 - 代码里手动写了
process.env.NODE_ENV = 'test'，发生在 dotenv 加载之后 - 用了
nodemon并在nodemon.json里声明了env，而 launch.json 的runtimeExecutable指向的是nodemon，此时以 nodemon 配置为准 - Windows 上用了 PowerShell 启动调试，而
env里写了 Unix 风格路径（如/path/to/node），导致整个 env 字段解析失败，静默丢弃
最稳的做法：在入口文件第一行打个日志，每次调试都看一眼输出，别信配置“应该”生效了。
