VSCode终端报“command not found: node”本质是shell未加载Node路径，需确保PATH包含node安装目录：macOS/Linux检查~/.zshrc是否source nvm.sh并重启VSCode；Windows确认安装时勾选“Add to PATH”或手动添加C:\Program Files\nodejs\到系统环境变量。
终端没反应或报错 command not found: node
这是最常见问题：VSCode 内置终端压根找不到 node。它用的是系统 shell（macOS/Linux 默认 zsh，Windows 默认 PowerShell 或 cmd），但 Node.js 的安装路径没被加进该 shell 的 $PATH 里——尤其是通过官网 pkg 安装 macOS、或使用 nvm 管理多版本时容易发生。
验证方式：在 VSCode 终端里直接运行 which node（macOS/Linux）或 where node（Windows），如果没输出，说明 shell 确实没加载 Node 环境。
- macOS + nvm：确保
~/.nvm/nvm.sh已在~/.zshrc（或~/.bash_profile）中 sourced，然后重启 VSCode（不是仅关闭终端） - Windows：检查 Node.js 安装时是否勾选了 “Add to PATH”，没勾选就重装，或手动把
C:\Program Files\nodejs\加进系统环境变量 - 通用兜底法：在 VSCode 终端里临时执行
source ~/.zshrc（macOS/Linux）或$env:Path += ";C:\Program Files\nodejs"（PowerShell），再试node -v
执行 node index.js 却提示 Cannot find module
不是 Node 找不到，而是当前工作目录不对。VSCode 内置终端默认打开位置是当前打开的文件夹（即 workspace root），但如果你从某个子文件夹里右键「在集成终端中运行」，或者手动 cd 过，node index.js 就会按当前路径去找 index.js，而不是你编辑器里正打开的那个文件。
- 最稳做法：在资源管理器里右键目标 JS 文件 → 「在集成终端中运行」，VSCode 会自动
cd到该文件所在目录再执行node xxx.js - 手动执行时，先确认当前路径：
pwd（macOS/Linux）或Get-Location（PowerShell），再用ls或dir看index.js是否真在当前目录 - 别依赖「当前打开的编辑器标签」位置，终端不认这个，只认 shell 的当前工作目录
脚本里用了 ES Module 语法，但 node index.js 报错 Cannot use import statement
Node.js 默认以 CommonJS 模式运行 JS 文件，遇到 import 就崩。这不是 VSCode 的问题，是 Node 版本和文件类型配置的事。
诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。
- 方案一：加
.mjs后缀（如index.mjs），然后运行node index.mjs—— Node 会自动识别为 ES Module - 方案二：在
package.json里加"type": "module"，这样同目录下所有.js都按 ES Module 解析 - 方案三：不用
import，改用require()和module.exports（CommonJS）写法，兼容性最好 - 注意：Node v12+ 才支持
type: module；v14+ 对.mjs支持更稳；低于 v12 的话，ESM 基本不可用
想一键运行、热更新，但不想每次敲 node 命令
VSCode 本身不提供“保存即运行”功能，得靠任务或插件补足。直接配 tasks.json 是最轻量、最可控的方式，比装一堆插件更少出错。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）→ 输入「Tasks: Configure Task」→ 选「Create tasks.json file from template」→ 选「Others」 - 替换生成的
tasks.json内容为：
{
"version": "2.0.0",
"tasks": [
{
"label": "run-node",
"type": "shell",
"command": "node",
"args": ["${file}"],
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showProblems": true
}
}
]
}
之后按 Ctrl+Shift+P → 「Tasks: Run Task」→ 选 run-node，就会用当前编辑器打开的文件执行 node。配合「保存自动触发任务」（需额外设 Ctrl+Shift+P → 「Preferences: Open Settings (JSON)」→ 加 "files.autoSave": "onFocusChange" 和 "task.autoRun": "onSave"）能接近热更新体验，但要注意：Node 本身不热重载，改完还得手动重启任务。
真正需要热更新（比如开发 HTTP server）时，别硬扛，直接上 nodemon：先 npm install --save-dev nodemon，再把 command 改成 "nodemon"，args 改成 ["${file}"] —— 这才是实际项目里靠谱的做法。
