vscode终端找不到node的根本原因是启动时未加载shell配置或未正确设置path：macos/linux需设terminal.integrated.shellargs为["-l"]并彻底重启，windows应确保安装时勾选add to path或手动添加至用户环境变量。
VSCode 终端找不到 node，多端编译根本启动不了
不是插件没装对，也不是 launch.json 写错了——根本原因是 VSCode 启动时压根没拿到 node 的路径。macOS/Linux 从 Dock 启动不读 ~/.zshrc，Windows 安装 Node.js 时漏勾 Add to PATH，就会导致 node -v 在终端里直接报 command not found。所有后续的多端构建（比如同时跑 Web、Electron、CLI）都卡在这一步。
验证方式只有一条：在 VSCode 内置终端（Ctrl + `）里敲 node -v。没输出，就别往下配 package.json 脚本或 tasks.json ——全是白忙。
- macOS/Linux：改完
~/.zshrc后，必须关掉所有 VSCode 窗口，再从终端执行code --no-sandbox .启动 - Windows：打开「系统属性 → 高级 → 环境变量」，确认「系统变量」的
Path中有C:Program Files odejs（注意路径不能含中文、空格，斜杠方向统一用/或\） - 更稳的做法：卸载重装 Node.js LTS 版，安装时务必勾选
Add to PATH，路径选C:/nodejs这类干净路径
terminal.integrated.env.* 是绕过系统 PATH 的关键
当你用 nvm/fnm/volta 管理多个 Node 版本，或者项目要求固定用 v18.17.0 编译 Electron，而系统 PATH 里是 v20，就得靠 VSCode 自己的环境变量注入机制——它不改系统，只在终端启动时把指定路径“前置”进 PATH，优先级高于系统原有值。
全局生效（所有项目都走这个 Node）：在 VSCode 设置里搜 terminal.integrated.env，编辑 settings.json：
{
"terminal.integrated.env.windows": {
"PATH": "C:/nodejs-v18;${env:PATH}",
"NODE_OPTIONS": "--enable-source-maps"
}
}
局部生效（仅当前项目）：在项目根目录建 .vscode/settings.json，内容同上，但路径换成你实际的 Node 安装目录（不是 node_modules，是 node.exe 所在目录）。
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
-
${env:PATH}必须保留，否则npm、git全挂 - Windows 路径中用
/或\都行，但不能混用单反斜杠 - 改完必须彻底重启 VSCode（不是重载窗口），否则新
PATH不加载
多端编译脚本依赖正确的终端环境，不是 launch.json
你在 package.json 里写 "build:web": "vite build"、"build:electron": "electron-builder"，这些命令最终是在 VSCode 终端里执行的。如果终端里的 PATH 没指向正确的 Node，vite 就会用错版本，打包产物可能缺失 ESM 支持或 process.versions.electron 为空。
VSCode 的任务系统（tasks.json）默认继承集成终端的环境变量，所以只要上面两步搞定，Ctrl + Shift + P → Tasks: Run Task 就能正常触发多端构建。
- 避免在
tasks.json里硬编码runtimeExecutable，那是给调试器用的，和任务无关 - 如果某个脚本仍报
Cannot find module 'vite'，说明npm install -g vite装到了错误的全局路径——检查npm config get prefix输出，确保它在当前PATH范围内 - Electron 构建失败常见于
electron和electron-builder版本不匹配，但这和环境变量无关，属于依赖管理问题
调试器 runtimeExecutable 和终端 PATH 是两套逻辑
即使 node -v 和 npm run build:web 都跑通了，F5 调试时仍可能报 Cannot find runtime 'node'。这是因为 VSCode 调试器（vscode-js-debug）不看终端的 PATH，它要么查系统全局 PATH，要么依赖 launch.json 里的 runtimeExecutable。
解决方法很简单：在项目根目录的 .vscode/launch.json 里，删掉 "runtimeExecutable" 这一行（让它走默认查找），或者显式指定路径：
{
"configurations": [{
"type": "pwa-node",
"request": "launch",
"name": "Launch Web",
"program": "${workspaceFolder}/src/index.js",
"runtimeExecutable": "C:/nodejs-v18/node.exe"
}]
}
- 用了 nvm/fnm？
runtimeExecutable必须写死路径，比如"~/.nvm/versions/node/v18.17.0/bin/node"（macOS/Linux）或"C:/Users/xxx/AppData/Roaming/nvm/v18.17.0/node.exe"（Windows） - 多端项目常需多个 launch 配置（Web/Electron/CLI），每个配置的
runtimeExecutable可以不同，但必须指向真实可执行文件 -
runtimeExecutable错误不会影响终端运行，只影响 F5 调试——这是最容易被忽略的割裂点
