VSCode中Node.js配置需区分终端、调试器和构建任务三类环境变量，三者互不互通；终端node -v失败应先检查shell PATH继承问题，而非直接修改launch.json。
能直接配，但必须分清是给终端用、还是给调试器用、还是给构建任务用——三者环境变量不互通，配错位置等于没配。
终端里 node -v 跑不通？先别动 launch.json
VSCode 内置终端找不到 node，根本不是 launch.json 的问题，而是它压根没继承你的 shell PATH。macOS/Linux 从 Dock 启动时不会读 ~/.zshrc；Windows 常见问题是安装 Node.js 时没勾选 Add to PATH，导致 C:\Program Files\nodejs 根本不在系统变量里。
- 验证方式只有一种：在 VSCode 终端（
Ctrl + `）里执行node -v，没输出就停手 - macOS/Linux：改完
~/.zshrc后，必须彻底退出所有 VSCode 窗口，再用code --no-sandbox .从终端启动 - Windows：进「系统属性 → 高级 → 环境变量」，检查「系统变量」的
Path是否含C:\Program Files\nodejs；路径含空格或斜杠方向错（比如写成C:\Program Files\nodejs\）都会失效 - 更稳妥做法：卸载重装 Node.js LTS 版，安装时务必勾选
Add to PATH，且路径避开中文和空格
launch.json 里怎么传 NODE_ENV 或 --inspect
调试器启动 Node 进程时，env 和 runtimeArgs 是唯二可控入口。前者设环境变量，后者传 node 命令行参数，两者不能混用。
-
env对象里写"NODE_ENV": "development"，这样process.env.NODE_ENV就能取到值 -
runtimeArgs数组里写"--inspect=0.0.0.0:9229"或"--trace-warnings"，注意是数组，不是字符串 - Express 项目入口通常是
bin/www，别写成app.js；TypeScript 项目要用ts-node，就得把runtimeExecutable设为"ts-node"，同时确保已全局或本地安装 - 如果用
nodemon调试，runtimeExecutable设为"nodemon"，再加"restart": true和"console": "integratedTerminal"
tasks.json 构建任务如何带参数运行 npm script
tasks.json 不支持直接展开 npm run build -- --watch 这种带双横线的参数，得靠 args 字段拆开传，否则会被当成 task 自身参数丢弃。
-
"command": "npm"，然后用"args": ["run", "build", "--", "--watch"]，这是唯一可靠写法 - 想复用
package.json里的"start": "NODE_ENV=production node dist/index.js"？不行——npm在 Windows 下不解析=，得拆成"env": {"NODE_ENV": "production"}+"args": ["run", "start"] - 需要前置清理？用
"dependsOn": ["clean"]，但clean任务也得定义在同一个tasks.json里，不能跨文件引用 -
"isBackground": true必须配给 watch 类任务（如tsc -w），否则 Ctrl+Shift+B 会卡住不动
为什么改了 settings.json 还不生效
terminal.integrated.env.* 和 launch.json 的 env 是两套完全独立的机制，改一个不影响另一个。而且 settings.json 里的环境变量注入，只对新打开的终端生效，旧终端要手动重启。
- 全局配置：在 VSCode 设置里搜
terminal.integrated.env，点编辑settings.json，加"terminal.integrated.env.windows": {"NODE_OPTIONS": "--max-old-space-size=4096"} - 项目级配置：在项目根目录建
.vscode/settings.json，内容同上，路径用osx或linux替换windows - 改完必须彻底重启 VSCode（不是重载窗口），否则新变量不加载
-
${env:PATH}必须保留在PATH注入值里，否则会覆盖掉系统原有 PATH，导致git、npm等命令失效
最常被忽略的是：终端、调试器、构建任务三者的环境变量完全隔离，改一处不等于全生效；还有就是 node -v 不通就配 launch.json，纯属白忙活。
