vscode运行不了node的根本原因是未继承系统path：macos从dock启动不加载~/.zshrc，需改配置后彻底重启或用code --no-sandbox启动；windows常因安装未勾选“add to path”导致路径缺失，应重装并勾选该选项。
VSCode 里运行不了 node，不是 VSCode 的问题，而是它根本没拿到系统 PATH 里的 node 路径——哪怕你在终端里敲 node -v 能成功，VSCode 启动时也可能完全不知道这命令在哪。
macOS 上 node 命令在终端可用，但 VSCode 报 “command not found”
这是最常见也最容易误判的问题。VSCode 图标双击启动时，不会加载你的 ~/.zshrc 或 ~/.bash_profile，所以即使你用 Homebrew 装了 Node，PATH 没被继承，VSCode 就找不到 node。
- 先确认 Node 安装路径：
which node（常见是/opt/homebrew/bin/node或/usr/local/bin/node） - 检查 shell 配置文件是否导出 PATH：
cat ~/.zshrc | grep PATH，确保有类似export PATH="/opt/homebrew/bin:$PATH"的行 - 别只改完就完事——必须重启 VSCode：关掉所有窗口，再从终端执行
code --no-sandbox启动，才能强制继承当前 shell 环境 - 如果用的是 Apple Silicon Mac（M1/M2/M3），Homebrew 默认装在
/opt/homebrew，旧教程里写/usr/local/bin很可能失效
用 code-runner 插件运行 JS 文件却卡住或乱码
这个插件默认用 node $fileName 执行，但不处理编码、不支持 ES Module、也不读取 stdin，一碰中文路径或 import 就崩。
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 打开 VSCode 设置 → 搜索
code-runner.executorMap→ 找到javascript对应的值 - 替换成：
"node --experimental-specifier-resolution=node -r utf-8 $fileName"（-r utf-8仅对 Windows 必要，macOS 一般不需要，但加了也无害） - 别指望它跑带
process.stdin.on('data', ...)的交互脚本——它根本不等你输入，直接退出；这类代码请手动进集成终端运行 - 如果项目用了
type: "module"或.mjs后缀，不加--experimental-specifier-resolution=node会报ERR_UNSUPPORTED_ESM_URL_SCHEME
调试时断点不生效，提示 “Cannot launch program because corresponding JavaScript cannot be found”
VSCode 的调试器（vscode-js-debug）默认找源码映射（source map）或原始 .js 文件，但如果你用 import、TS 编译、Vite/Webpack 打包，它很可能压根没看到入口文件。
- 优先检查
.vscode/launch.json中的program字段是否指向真实可执行的 JS 文件（比如${workspaceFolder}/src/index.js），而不是 TS 或打包后的 dist - 如果是 TypeScript 项目，确保已生成
.js和对应.js.map，且launch.json里加了"sourceMaps": true - 用 Vite 创建的项目，别直接调试
main.ts——它不是运行时入口，得调试开发服务器启动后的实际产物，或改用vite dev+ 浏览器 DevTools - Node.js v20+ 默认启用 ESM，若
package.json没设"type": "module"却用了import，调试器会静默失败，此时需显式加"runtimeArgs": ["--experimental-specifier-resolution=node"]
真正卡住人的地方，往往不是“怎么装”，而是“谁该知道 node 在哪”——Shell、VSCode、code-runner、debugger 各自维护一套环境变量和执行逻辑，漏掉任意一环，都会让你在 node -v 成功后，依然跑不起一行 console.log。
