VSCode找不到node的根本原因是环境变量未正确继承：macOS/Linux因Shell初始化文件未加载，Windows因安装时未勾选“Add to PATH”；需分别通过终端启动code、重装Node或手动配置PATH解决。
VSCode 本身不带 Node.js 运行时，所有“运行 JS”“调试 JS”的能力都依赖系统已安装且可被正确发现的 node 命令。如果终端里能跑 node -v，但 VSCode 里报 command not found: node，问题一定出在环境变量继承上，不是插件、不是设置、更不是 VSCode 故障。
为什么 VSCode 找不到 node，即使终端里能用？
根本原因是 VSCode 启动方式绕过了 Shell 初始化逻辑。macOS/Linux 下，code 命令从 Dock 或 Spotlight 启动时，不会加载 ~/.zshrc 或 ~/.bash_profile；Windows 下则常因 Node.js 安装时没勾选 “Add to PATH” 导致系统级 PATH 缺失。
- macOS/Linux：检查
which node输出路径（如/opt/homebrew/bin/node），确认该路径是否出现在~/.zshrc的export PATH="...:$PATH"中；改完后别只source ~/.zshrc，必须重启 VSCode —— 甚至推荐从终端启动：code --no-sandbox . - Windows：打开系统环境变量面板，确认
C:\Program Files\nodejs\已加到“系统变量”或“用户变量”的PATH里；若不确定，重装 Node.js 并**务必勾选 “Add to PATH”** - 验证是否生效：在 VSCode 内置终端（
Ctrl+`）中直接执行node -v，必须有输出；没有就别往下配launch.json了
用集成终端跑 JS 脚本时乱码、卡住、或不支持 import？
code-runner 插件默认命令太简陋，不处理编码、模块类型和输入流，尤其在 Windows 中文路径或 ESM 项目下极易出问题。
- 乱码（Windows）：在 VSCode 设置中搜索
code-runner.executorMap，把javascript对应值改成："node -r utf-8 $fileName" - ESM 报错
Cannot use import statement outside a module：确保项目根目录package.json有"type": "module"，再把 executor 改成："node --experimental-specifier-resolution=node $fileName" - 遇到
process.stdin就假死：code-runner不支持交互式输入，换用内置终端手动跑，或改用调试模式（F5）
断点不命中、提示 “Cannot launch program because corresponding JavaScript cannot be found”？
这不是代码写错了，而是调试器找不到真实可执行的 JS 文件，或者源映射（source map）没对齐。常见于 TypeScript、打包后项目或 ESM/CJS 混用场景。
立即学习“Java免费学习笔记（深入）”；
-
launch.json中的"program"必须指向编译后的.js文件，比如"${workspaceFolder}/dist/index.js"，而不是.ts或.mjs源文件 - TypeScript 项目：编译时必须开启
"sourceMaps": true，且生成的index.js.map必须和index.js在同一目录 - ESM 项目：除了
package.json加"type": "module"，launch.json还得显式加"runtimeArgs": ["--loader", "ts-node/esm"]（若用ts-node） - 路径错误是最隐蔽的坑：用
${workspaceFolder}而不是相对路径，避免cwd错位导致require()或import解析失败
不想建文件、不配配置，只想快速试一段代码？
VSCode 自带的 JavaScript Debug Terminal 就是为此设计的——它本质是带完整调试能力的 REPL，无需保存文件、不用写 launch.json，支持 await、支持模块导入（只要当前目录有 package.json），还能设断点看变量。
- 打开命令面板（
Ctrl+Shift+P），输入JavaScript Debug Terminal，回车 - 在新开终端里直接写
console.log('hello')或await fetch('/api')，回车即执行 - 想调试某段逻辑？把代码粘进去，然后在行号左侧单击设断点，它会自动暂停并展示作用域
- 注意：它不读取
launch.json，也不走code-runner，所以不受那些配置干扰，特别适合碎片化验证
真正卡住的从来不是语法或插件，而是 node 命令在哪、program 指向哪、sourceMap 在哪——这三个路径没对齐，再漂亮的配置也白搭。
