VSCode找不到node的根本原因是环境变量未正确继承：macOS/Linux因GUI启动不加载shell配置文件，Windows因Node.js安装时未勾选“Add to PATH”；需分别通过终端启动code、重装Node或手动配置PATH解决。

VSCode 本身不带 Node.js 运行时，所有“运行 JS”“调试 JS”的能力都依赖系统已安装且可被正确发现的 node 命令。如果终端里能跑 node -v，但 VSCode 里报 command not found: node，问题一定出在环境变量继承上，不是插件、不是设置、更不是 VSCode 故障。

VSCode 找不到 node：根本是 PATH 没继承

macOS/Linux 下，从 Dock 或 Spotlight 启动 VSCode 不会加载 ~/.zshrc 或 ~/.bash_profile；Windows 下常因 Node.js 安装时没勾选 “Add to PATH” 导致系统级 PATH 缺失。

• macOS/Linux：运行 which node 查路径（比如 /opt/homebrew/bin/node），确认该路径是否出现在 ~/.zshrc 的 export PATH="...:$PATH" 中；改完必须重启 VSCode —— 更推荐直接从终端启动：code --no-sandbox .
• Windows：打开系统环境变量面板，确认 C:\Program Files\nodejs\ 已加到“系统变量”或“用户变量”的 PATH 里；不确定就重装 Node.js，并务必勾选 “Add to PATH”
• 验证是否生效：在 VSCode 内置终端（Ctrl+`）中执行 node -v，必须有输出；没有就别往下配 launch.json 了

用 code-runner 跑 JS 却乱码/卡住/不支持 import

这个插件默认命令太简陋，不处理编码、模块类型和输入流，尤其在 Windows 中文路径或 ESM 项目下极易出问题。

OC SSH Tunnel Node Recovery

诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。

下载

• 乱码（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 混用场景。

• 确保 .vscode/launch.json 中 program 字段指向的是真实可执行的 JS 文件（比如 ./dist/index.js），不是 .ts 或 .mjs 源文件
• 如果用了 TypeScript，必须开启 sourceMaps: true，且编译后的 .js.map 文件和 .js 在同一目录
• ESM 项目要加 "type": "module" 到 package.json，否则调试器会按 CJS 解析，路径解析错乱

最常被忽略的其实是 Shell 初始化逻辑是否完整加载 —— macOS/Linux 用户容易以为 source ~/.zshrc 就够了，其实 VSCode 进程未必继承它；Windows 用户则常把“用户变量 PATH”当“系统变量 PATH”，结果 GUI 启动的程序根本看不见。环境变量这事，差一个路径、少一次重启，就全卡住。