VSCode终端找不到node命令，根本原因是启动时未加载shell配置文件（如~/.zshrc）或系统PATH未包含Node.js路径；macOS/Linux需从终端执行code .启动或设shellArgs为["-l"]并彻底重启，Windows需在系统变量Path中添加C:Program Files odejs并确保安装时勾选“Add to PATH”。
VSCode终端找不到node命令？先确认PATH继承是否生效
根本不是VSCode设置问题，而是它启动时没加载你的shell配置（如~/.zshrc）或系统PATH压根没写入Node.js路径。macOS/Linux下从Dock或Spotlight启动VSCode，进程不会读~/.zshrc；Windows则常因安装时漏选Add to PATH导致C:Program Files
odejs根本不在系统变量里。
验证方式只有一种：在VSCode内置终端（Ctrl + `）里直接执行node -v。没输出就别往下配launch.json或插件——所有后续操作都是空转。
- macOS/Linux：改完
~/.zshrc后，必须彻底退出所有VSCode窗口，再从终端执行code --no-sandbox .启动 - Windows：打开「系统属性 → 高级 → 环境变量」，检查「系统变量」的
Path中是否有C:Program Files odejs；有但无效，大概率是路径含空格、斜杠方向错，或被其他软件覆盖 - 更稳妥做法：卸载Node.js，重装LTS版，安装时务必勾选
Add to PATH，且路径避开中文和空格
terminal.integrated.env.*能绕过系统PATH限制
当你没权限改系统环境变量，或需要为单项目指定Node版本（比如用nvm管理多个版本），就得靠VSCode自己的环境变量注入机制。它不修改系统PATH，而是在终端启动时把指定路径“前置”进环境变量，优先级高于系统原有PATH。
- 全局生效（所有项目都用这个Node）：在VSCode设置中搜
Env，点开terminal.integrated.env.windows（macOS/Linux对应.linux或.osx），编辑settings.json：
{
"terminal.integrated.env.windows": {
"PATH": "C:/path/to/your/node;${env:PATH}",
"NODE_PATH": "C:/path/to/your/node"
}
}
- 局部生效（仅当前项目）：在项目根目录建
.vscode/settings.json，内容同上。注意路径中的C:/path/to/your/node要替换成你实际解压或安装的node.exe所在目录（不是node_modules） - Windows路径用正斜杠
/或双反斜杠\均可，但不能混用单反斜杠 -
${env:PATH}必须保留，否则会丢掉系统原有PATH，导致npm、git等命令失效 - 改完保存后，必须重启VSCode（不是重载窗口），否则新
PATH不加载
launch.json里runtimeExecutable什么情况下必须显式指定？
仅当你要：①调试非默认版本（比如项目要求 Node.js 18，但系统默认是 20）；②使用自定义构建的node（如 Electron 内置 runtime）；③在容器或 WSL 中调试但主机 PATH 不一致。
- 显式指定示例：
{
"configurations": [{
"type": "node",
"request": "launch",
"name": "Launch with Node 18",
"runtimeExecutable": "/Users/you/.nvm/versions/node/v18.19.1/bin/node",
"program": "${workspaceFolder}/index.js"
}]
}
- 不要为“统一版本”而硬编码路径——这会让团队协作失效；改用
nvm+ 终端启动才是可持续方案 -
runtimeVersion字段（VSCode 1.85+）可声明期望版本，但不会自动切换，仅用于提示不匹配时告警 - 即使
node -v在终端里跑通了，launch.json里仍可能报Cannot find runtime 'node'——调试器和终端走的是两套PATH逻辑
npm install成功但require()报Cannot find module？
这不是 Node.js 环境配置失败，而是 VSCode 的 JavaScript/TypeScript 语言服务未识别node_modules结构，常见于：单仓库多包（monorepo）、软链接依赖（npm link）、或package.json缺少"type": "module"导致CJS/ESM 混用。
- 先运行
npm ls <module-name>确认模块真实存在且无extraneous标记 - 确保项目根目录有有效的
jsconfig.json（JS项目）或tsconfig.json（TS项目），且含"type": "module"或{"compilerOptions": {"allowJs": true}} - 禁用所有非必要插件，尤其那些宣称“增强 JS 支持”的第三方插件——VS Code 内置的JavaScript and TypeScript语言功能已足够，插件冲突反而导致跳转失败
最容易被忽略的是：VSCode 的终端是否继承了你 shell 里已生效的 npm 配置。如果在系统终端能用nodemon，但在 VSCode 里提示 command not found，大概率是终端没读取 shell 配置文件，这时重启 VSCode 或手动在终端里执行source ~/.zshrc更直接。
