vscode本身不提供node.js环境，所谓“绑定”只是正确调用系统已安装的node命令；若终端中node -v成功但vscode报command not found，根本原因是启动方式绕过shell初始化逻辑，导致path未继承——macos/linux从dock启动不加载~/.zshrc，windows常因安装时未勾选add to path。
VSCode 本身不提供 Node.js 运行环境，所谓“绑定”只是让它能正确找到系统已安装的 node 命令 —— 如果终端里 node -v 能输出版本号，但 VSCode 里报 command not found: node，问题一定出在环境变量继承上，不是插件、不是设置、更不是重装 VSCode 能解决的。
为什么 VSCode 内置终端找不到 node，即使 CMD/PowerShell 里能用？
根本原因是启动方式绕过了 shell 初始化逻辑。macOS/Linux 下从 Dock 或 Spotlight 启动 VSCode，不会加载 ~/.zshrc 或 ~/.bash_profile；Windows 下则多因安装 Node.js 时没勾选 Add to PATH，导致系统级 PATH 根本没包含 node 路径。
- 先确认真实路径：
which node（macOS/Linux）或where node（Windows），看输出是否指向有效目录（如/opt/homebrew/bin/node或C:\Program Files\nodejs\node.exe） - macOS/Linux：检查该路径是否已写入 shell 配置文件的
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 里 program 和 runtimeExecutable 怎么填才不踩坑？
调试器启动失败、断点不命中、提示 Cannot launch program because corresponding JavaScript cannot be found，90% 是因为 program 指向了错误路径，或误加了不必要甚至冲突的 runtimeExecutable。
-
"program": "${file}"适合单文件快速调试；如果主入口是src/app.js，就显式写成"program": "${workspaceFolder}/src/app.js" - 不要手动填
runtimeExecutable，除非你明确用nvm/fnm切换版本且需要锁定路径（例如"runtimeExecutable": "~/.nvm/versions/node/v18.18.2/bin/node"） - TypeScript 或打包项目（Vite/Webpack）：
program必须指向编译后的.js文件（如dist/index.js），不能是.ts或.jsx源码 - ESM 项目必须在
package.json中设"type": "module"，否则调试器按 CommonJS 解析，import直接报错
Code Runner 插件跑 JS 乱码、卡住、不支持 process.stdin 怎么修？
它默认命令极简：node $fileName，不处理编码、模块类型、输入流，遇到中文路径、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 调试模式（它支持 stdin） - 别指望它替代调试器 —— 它只适合简单输出类脚本，复杂逻辑、异步、错误捕获全靠不住
最常被忽略的一点：VSCode 调试器底层依赖 npm 启动脚本，所以 npm -v 必须在终端和 VSCode 内置终端里都成功，否则即使 node -v 正常，F5 也可能静默失败。别跳过这步验证。
