根本原因是VSCode启动时未继承正确的PATH环境变量：macOS/Linux不加载shell配置文件，Windows可能缓存旧PATH；需重启VSCode并配置terminal.integrated.env.windows或shellArgs.-l参数。

VSCode 终端报 “node 不是内部或外部命令” 的根本原因

这不是 Node.js 没装，而是 VSCode 启动时没拿到正确的 PATH。macOS/Linux 下它不加载 ~/.zshrc 或 ~/.bash_profile；Windows 下它可能只继承了旧的环境变量快照，尤其当你用 nvm-windows 切换版本后——PATH 变了，但 VSCode 进程还在用启动时缓存的老值。

先验证：你的系统终端能跑 node，VSCode 里却不行？

执行这三步快速定位：

• 在系统原生终端（不是 VSCode 里）运行 where node（Windows）或 which node（macOS/Linux），确认路径真实存在，比如 D: vm4w odejs ode.exe 或 /opt/homebrew/bin/node
• 在 VSCode 集成终端里执行 echo $PATH（macOS/Linux）或 $env:Path（PowerShell），看输出里有没有上面那个路径
• 如果没出现，说明环境变量压根没传进来——别调 launch.json，先修环境

Windows + nvm-windows 用户：必须补 PATH 到 VSCode 设置

你装在 D: vm4w odejs，但系统 PATH 里没加，或者加了却只加在“系统变量”里，VSCode 启动时读不到。直接改 VSCode 用户设置最稳：

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• 按 Ctrl + Shift + P → 输入 Preferences: Open Settings (JSON)
• 添加这段（注意双反斜杠）：

  { "terminal.integrated.env.windows": { "PATH": "${env:PATH};D:\nvm4w\nodejs" } }

• 保存后，**必须彻底退出 VSCode 进程**（Windows 任务管理器结束所有 Code.exe），再重开
• 新开终端执行 node -v，如果还报错，再跑一次 Get-Command node 看路径是否真被识别

macOS/Linux：强制加载 shell 配置文件

VSCode 图标启动默认走 non-login shell，跳过所有 export PATH=。解决方法简单但容易漏：

• 打开 VSCode 设置 JSON，加这一行：

  "terminal.integrated.shellArgs.osx": ["-l"], "terminal.integrated.shellArgs.linux": ["-l"]

• -l 是小写 L，不是数字 1；它让终端启动时走 login 流程，从而加载 ~/.zshrc 或 ~/.bash_profile
• 改完后不能只是关窗口——macOS 要右键 Dock 图标选「退出」，Linux 要 kill 所有 code 进程，否则旧环境还在
• 如果 ~/.zshrc 开头有 [[ -n $ZSH_EVAL_CONTEXT ]] && return 这类防护逻辑，加一句 echo "zshrc loaded" 验证是否真执行了

真正麻烦的从来不是加一行 PATH，而是 VSCode 进程不重启、shellArgs 写错字母、或者 nvm use 之后没 reload terminal——这些点漏一个，node -v 就永远卡在 command not found。