VSCode中Node命令找不到需先检查系统PATH是否包含Node路径并重启VSCode；并发脚本用npm-run-all配合--parallel和--aggregate-output；调试需配置launch.json多config及compounds；跨平台推荐统一使用npm-run-all加--race。
VSCode里Node命令找不到？先确认PATH和终端继承
VSCode默认会继承系统PATH，但Windows用户常遇到node或npm在集成终端里报“未识别的命令”——这不是VSCode没装Node，而是它启动时没读到你安装Node的路径。macOS/Linux一般没问题；Windows上尤其要注意：如果用nvm-windows或手动解压安装，必须确保PATH包含Node可执行文件所在目录（比如C:\Program Files\nodejs\），且该PATH在Windows系统环境变量中生效（不是仅用户变量，也不是PowerShell Profile里临时加的）。
验证方式：关掉所有VSCode窗口，重新打开，运行which node（macOS/Linux）或where node（Windows CMD）；如果没输出，说明VSCode根本没加载到Node。别急着改settings.json，先去系统环境变量里补全并重启VSCode。
package.json里怎么写并发脚本才不卡住？npm-run-all是关键
npm-run-all不是内置工具，得先装：npm install --save-dev npm-run-all。它解决的是npm run dev & npm run watch这种原生&写法在Windows下失效、进程无法正确终止、输出混杂的问题。
- 串行用
npm-run-all --serial start:server start:client，适合有依赖顺序的场景 - 并发用
npm-run-all --parallel dev:server dev:client，这才是你要的“同时跑两个服务” - 推荐写进
scripts里："dev": "npm-run-all --parallel dev:server dev:client"，然后VSCode终端里只敲npm run dev就行 - 注意：每个子脚本（如
dev:server）必须是独立可退出的命令，比如nodemon server.js或webpack serve；别写node server.js这种没热重载、不响应SIGINT的，否则Ctrl+C杀不干净
VSCode调试器连不上并发进程？launch.json要配多个config
VSCode默认只支持一个launch.json配置启动一个进程。想同时断点调试API服务和前端本地服务，得手动加多个configurations，再用compounds组合：
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Debug Server",
"program": "${workspaceFolder}/server.js",
"console": "integratedTerminal",
"env": { "NODE_ENV": "development" }
},
{
"type": "chrome",
"request": "launch",
"name": "Debug Client",
"url": "http://localhost:3000",
"webRoot": "${workspaceFolder}/src",
"port": 9222
}
],
"compounds": [
{
"name": "Debug Full Stack",
"configurations": ["Debug Server", "Debug Client"]
}
]
}
这样点绿色三角就能一起启服务+开Chrome+挂断点。但注意：Chrome调试需要提前在Chrome地址栏输入chrome://flags/#remote-debugging-port开启远程调试端口（默认9222），否则连不上。
并发脚本输出乱成一团？用--race和--aggregate-output控制
npm-run-all默认把所有子进程输出直接打到同一终端，日志交叉难定位。加--aggregate-output能把各脚本输出按前缀分开，比如[server]和[client]；加--race还能让任一子进程退出时，立刻终止其余所有进程（避免服务器崩了前端还在跑）。
实操建议：
- 开发时用：
"dev": "npm-run-all --parallel --aggregate-output --race dev:server dev:client" -
--aggregate-output会自动给每行加[script-name]前缀，不用自己写npm-run-all --print-label - 如果某个脚本启动慢（比如数据库连接），可加
--max-old-space-size=4096等Node参数，但要写在子脚本里，不是传给npm-run-all
真正麻烦的是跨平台兼容性：Windows对concurrently更友好，但npm-run-all在macOS/Linux下信号处理更稳；如果团队混用系统，建议统一用npm-run-all并加--race，避免某人Ctrl+C后残留进程占端口。
