设置NODE_ENV启动Node.js项目失败该如何解决

启动失败核心原因是不同操作系统、不同终端的临时环境变量设置语法不兼容，错误的命令写法会导致环境变量注入失败、进程启动异常。 #

各终端原生正确写法 #

• Linux/macOS（bash/zsh终端）：直接使用类Unix标准语法即可，设置的变量仅对当前启动进程生效：

  NODE_ENV=production node index.js
  

• Windows CMD终端：set命令和node启动命令不能写在同一行，必须分两行执行：

  set NODE_ENV=production
  node index.js
  

  之前执行的set NODE_ENV=something node index.js属于错误写法，同一条命令内CMD无法将设置的变量传递给后续node进程。
• Windows PowerShell终端：需要使用$env:前缀声明环境变量，同样分两行执行：

  $env:NODE_ENV = "production"
  node index.js
  

跨平台通用方案（推荐） #

多系统协作的项目不需要单独适配不同终端语法，直接用cross-env统一命令即可：

1. 安装开发依赖：

   npm install cross-env -D
   

2. 在项目package.json的scripts字段配置启动命令：

   {
     "scripts": {
       "start:prod": "cross-env NODE_ENV=production node index.js"
     }
   }
   

3. 所有系统下直接执行npm run start:prod即可正常注入环境变量启动项目，无兼容问题。

额外排查项 #

如果调整命令后仍启动失败，优先检查两个基础问题：

• 终端执行node -v能正常输出版本号，确认Node.js已正确加入系统环境变量
• 执行命令的当前目录下存在index.js入口文件，避免路径错误导致启动失败

问题描述截图

内容的提问来源于stack exchange，提问作者Mahmudul Islam