Windows 10下React项目package.json启动脚本PORT报错的修改咨询

针对Windows 10环境下的启动脚本修改，提供三种可行方案：

方案1：CMD兼容的原生写法 #

直接用Windows CMD的set命令设置环境变量，修改后的scripts部分如下：

"scripts": {
  "start": "set PORT=3333 && node scripts/start.js",
  "build": "node scripts/build.js",
  "test": "node scripts/test.js --env=jsdom"
},

原理：Windows CMD中通过set定义环境变量，&&用于串联执行后续的Node命令，确保环境变量在Node进程生效。

方案2：跨平台通用写法（推荐） #

如果需要脚本同时兼容Windows、Linux/macOS，可借助cross-env包统一环境变量设置逻辑：

1. 先安装依赖：

npm install cross-env --save-dev

2. 修改start脚本：

"scripts": {
  "start": "cross-env PORT=3333 node scripts/start.js",
  "build": "node scripts/build.js",
  "test": "node scripts/test.js --env=jsdom"
},

原理：cross-env会自动识别操作系统，适配对应的环境变量设置语法，无需为不同系统单独编写脚本。

方案3：PowerShell专属写法 #

如果你的VS Code终端默认使用PowerShell，可直接用PowerShell的环境变量语法：

"scripts": {
  "start": "$env:PORT=3333; node scripts/start.js",
  "build": "node scripts/build.js",
  "test": "node scripts/test.js --env=jsdom"
},

注意：此写法仅在PowerShell环境生效，通用性不如前两种方案。

额外检查点 #

修改后若仍无法启动，可检查scripts/start.js文件：

• 确认代码中是否通过process.env.PORT正确读取端口
• 排查是否存在硬编码的端口配置，导致环境变量被覆盖

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