vscode终端无法运行node的根本原因是未加载shell初始化文件导致path缺失；需将terminal.integrated.profiles中对应shell的args设为["-l"]并彻底重启vscode，macos/linux检查~/.zshrc是否含nvm初始化代码，windows需处理powershell执行策略或改用cmd终端。

VSCode 自带终端无法运行 node，90% 的情况不是 Node 没装，而是它压根没读到你的 PATH —— 终端启动时跳过了 shell 初始化文件（比如 ~/.zshrc），导致所有 export PATH=... 都没生效。

VSCode 终端为啥不加载 ~/.zshrc？

macOS/Linux 下双击图标或 Spotlight 启动 VSCode，默认以 non-login shell 运行终端，~/.zshrc 里的 PATH 设置完全被忽略。系统终端能用 node，是因为你手动开的 Terminal 是 login shell，自动执行了初始化脚本。

• 验证方式：在 VSCode 终端里执行 echo $0，如果输出是 zsh（没带 - 前缀）或 shopt login_shell 返回 off，就坐实了
• 临时补救：在终端里手动运行 source ~/.zshrc，再试 node -v —— 成功说明问题定位准确
• 永久解法：打开 VSCode 设置 → 搜索 terminal.integrated.profiles → 找到 zsh（或 bash）配置项 → 加入 "args": ["-l"]（小写 L，不是数字 1）
• 改完必须彻底退出 VSCode：macOS 右键 Dock 图标选「退出」，Windows 在任务管理器结束所有 Code.exe 进程，再重开

node 命令存在但版本不对（尤其用了 nvm）

即使 node 可执行，终端也可能调用系统自带旧版（如 macOS 的 /usr/bin/node），而你用 nvm 安装的新版本根本没激活。

Zenlink - Node SDK for ZenHeart

ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。

下载

• 执行 which node 和 nvm current，两者输出路径必须一致；不一致说明 nvm 初始化代码没跑
• 检查 ~/.zshrc 是否包含这两行（顺序不能错）：
  export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
• 如果 ~/.zshrc 开头有 [[ -n $ZSH_EVAL_CONTEXT ]] && return 这类防护逻辑，它会提前退出 —— 加一句 echo "zshrc loaded" 就能验证是否真被读取
• nvm use v18.19.0 必须在每次终端会话中执行（或写进 ~/.zshrc 末尾），否则 nvm 不会自动切换版本

Windows 上 PowerShell 策略阻止 nvm 或自定义路径加载

PowerShell 默认禁止执行本地脚本，nvm.ps1 或环境变量中的路径会被拦截，表现为 node 不识别或报错 cannot be loaded because running scripts is disabled。

• 临时允许：在 VSCode 终端里运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
• 更稳妥做法：把 VSCode 默认终端换成 Command Prompt（设置里搜 terminal.integrated.defaultProfile.windows，设为 Command Prompt）
• 若坚持用 PowerShell，确保 nvm 安装路径（如 C:UsersXXX vm）已加进系统 PATH，并且 where node 输出指向该目录下的 node.exe
• 别只加系统变量 PATH —— 普通用户登录时不一定继承；优先往「用户变量」PATH 里加，避免权限问题

调试器能用 node，但终端不能？那是两套环境

VSCode 调试器（launch.json）和构建任务（tasks.json）启动的是全新进程，完全不继承终端环境变量。终端能跑 node -v ≠ 调试器能找得到 node。

• 调试器报 Cannot find runtime 'node'，得在 launch.json 的 configurations 里加 "env": { "PATH": "${env:PATH};/usr/local/bin" }（macOS/Linux）或 "env": { "PATH": "${env:PATH};C:\Program Files\nodejs\" }（Windows）
• 注意平台键：用 terminal.integrated.env.windows、.linux、.osx 分开配置，别混用
• envFile 只读 .env 文件里的键值对，它补不了 PATH —— 别指望靠它解决根本问题
• runtimeExecutable 字段虽能硬编码路径，但一旦换机器或换 nvm 版本就得手动改，不如修好全局 PATH 一劳永逸

最常被忽略的点：改完 ~/.zshrc 或系统 PATH 后，只重启终端 tab 是无效的 —— VSCode 主进程没重载 shell 环境，必须彻底退出再开。还有人卡在 nvm 初始化代码被跳过，却死磕 VSCode 设置，方向错了。