VSCode终端node -v报command not found而系统终端正常，根本原因是其启动时未加载shell配置文件（如~/.zshrc），导致PATH缺失；macOS/Linux需设terminal.integrated.shellArgs为["-l"]并彻底重启VSCode，Windows应修正用户环境变量或手动配置terminal.integrated.env.windows。

VSCode终端里node -v报command not found，但系统终端能用

根本不是Node没装好，是VSCode启动时没加载你的shell配置文件（比如~/.zshrc或~/.bash_profile）。macOS/Linux下双击图标启动的VSCode默认跑的是non-login shell，跳过所有export PATH=逻辑。

先验证：在VSCode终端执行echo $PATH，对比系统终端输出。缺了/opt/homebrew/bin（Apple Silicon）、/usr/local/bin或你自定义的Node路径，就坐实了。

• 临时解法：改VSCode设置terminal.integrated.shellArgs为["-l"]（小写L），强制走login流程
• 改完必须彻底退出VSCode（macOS右键Dock选「退出」，Windows任务管理器结束所有Code.exe进程），再重新打开
• 如果~/.zshrc开头有[[ -n $ZSH_EVAL_CONTEXT ]] && return这类防护，会提前退出——加一句echo "zshrc loaded"就能验证是否真被读取

Windows上npm提示“无法将'npm'项识别为cmdlet”

这不是PowerShell权限问题，而是VSCode继承了错误的PATH：要么Node安装时没勾选“Add to PATH”，要么你用nvm-windows装在非默认路径（比如D: vm4w odejs），但系统PATH里没填这个位置。

Zenlink - Node SDK for ZenHeart

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

下载

先查真实Node路径：where node（CMD）或Get-Command node（PowerShell），确认输出是不是C:Program Files odejs ode.exe或D: vm4w odejs ode.exe。

• 路径不对？去系统环境变量面板，把正确路径加到“用户变量”的PATH里（别只加系统变量，普通用户登录时不一定继承）
• 若用nvm-windows，推荐在VSCode设置JSON里直接补PATH："terminal.integrated.env.windows": { "PATH": "${env:PATH};D:\nvm4w\nodejs" }
• 注意分隔符是;，不是:；${env:PATH}必须保留，否则连notepad都打不开

调试时F5报“找不到Node.js二进制文件'node'”，但终端能跑node -v

终端能用≠调试器能用。VSCode的调试器（launch.json）和构建任务（tasks.json）启动的是全新进程，完全不继承终端环境变量——它们的PATH是空的，除非你手动喂进去。

• launch.json里不能写environment（已弃用），得用env字段："env": { "PATH": "${env:PATH};/usr/local/bin" }
• Windows下路径拼接用;，Linux/macOS用:，平台键要写对：terminal.integrated.env.windows、.linux、.osx
• 别在configurations外层写env，那位置无效；也别指望envFile自动补PATH，它只读.env里的键值对

用nvm/nvm-windows切换版本后，VSCode终端突然失效

nvm修改的是注册表或shell环境变量，但VSCode已运行的进程不会实时监听变更。尤其用快捷方式启动时，它读的是旧快照。

• 每次用nvm use切换后，必须在VS Code里重启集成终端：按Ctrl+Shift+P → 输入Terminal: Reload Shell Environment，或者直接关掉当前终端tab再新建一个
• 检查nvm root和nvm version输出是否一致，有时nvm install成功但nvm use没真正激活（比如目标版本没真正下载完）
• 不要依赖“自动继承”，nvm的环境变更不是广播给所有进程的信号，而是靠新shell进程读取新变量

实际排查时最容易被跳过的点：VSCode必须完全退出（不是关窗口），才能让新PATH生效；macOS上~/.zshrc里如果有条件判断提前return，source也不管用；Windows下PowerShell和CMD的PATH不共享，得分别确认。