vscode终端报“command not found”根本原因是node.js未正确加入系统path或vscode未加载shell配置文件；windows需重装并勾选“add to path”，macos/linux需设terminal.integrated.profiles中shell的args为["-l"]并彻底重启vscode。

VSCode 里不能通过终端“安装” Node 环境 —— 终端只是调用工具的入口，Node.js 必须先在系统层面装好，否则任何 npm install 或 node -v 都会失败。

为什么在 VSCode 终端执行 node -v 报 “command not found”

这不是 VSCode 的 bug，而是终端没继承到系统 PATH。常见现象包括：

• 系统 CMD/PowerShell 里 node -v 正常，但 VSCode 内置终端报错
• 重装 Node.js 后，旧终端窗口仍找不到 node
• 用了 nvm-windows 却始终提示 node 未识别

根本原因只有两个：Node.js 没进系统 PATH，或 VSCode 启动时没加载 shell 初始化逻辑。Windows 用户最常漏掉安装时勾选 “Add to PATH”；macOS/Linux 用户则多因 VSCode 终端默认以非登录模式启动，跳过了 ~/.zshrc 或 ~/.bash_profile 加载。

Windows 下确保 node 和 npm 在 VSCode 终端可用

必须按顺序操作，跳过任一环节都可能白忙：

Rydberg Agent Node

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

下载

• 卸载现有 Node.js（控制面板 → 卸载程序），重新从 nodejs.org/download 下载 LTS .msi 包
• 安装过程中务必勾选 “Add to PATH”（这是唯一可靠方式；ZIP 版需手动配置环境变量，极易出错）
• 安装完成后，关闭所有已打开的 CMD、PowerShell、VSCode 进程（任务管理器确认 Code.exe 已退出）
• 全新打开 CMD，运行 where node 和 where npm，输出应类似：C:\Program Files\nodejs\node.exe 和 C:\Program Files\nodejs\npm.cmd
• 再启动 VSCode，按 Ctrl + ` 打开终端，立刻执行 node -v 和 npm -v —— 有输出才算真正生效

macOS/Linux 下 VSCode 终端不识别 nvm 或 node

问题不在 Node.js 本身，而在 shell 配置未被 VSCode 终端读取：

• 检查 ~/.zshrc（或 ~/.bash_profile）是否包含完整 nvm 初始化代码：
  export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
• 在 VSCode 设置中搜索 terminal.integrated.profiles，找到对应 shell（如 zsh）的配置项，添加 "args": ["-l"]（-l 表示 login shell，强制加载配置文件）
• 修改后必须完全退出 VSCode（不只是关终端），再重新打开项目文件夹，否则配置不生效
• 验证：终端中运行 echo $PATH，确认输出包含 $NVM_DIR/versions/node/... 路径；再执行 nvm current 和 which node，两者路径应一致

npm install -g 全局命令在 VSCode 终端里找不到

这说明全局 bin 目录没进 PATH，和 node 不可用是同类问题，但更隐蔽：

• 如果执行过 npm config set prefix（比如设为 D:\npm-global），就必须把该路径加进系统环境变量 Path（Windows）或 ~/.zshrc 中的 export PATH=...（macOS/Linux）
• 加完后，不是重启终端，而是彻底关闭并重开 VSCode —— 它的集成终端不会动态刷新 PATH
• 验证方式：在 VSCode 终端中运行 npm config get prefix，再运行 ls -la $(npm config get prefix)/bin（macOS/Linux）或 dir %APPDATA%\npm（Windows），确认 nodemon、http-server 等命令文件存在

最容易被忽略的是：VSCode 终端是否真的加载了你改过的 shell 配置。哪怕 node 可用了，npm 全局命令也可能因路径未同步而失效 —— 它们依赖的 PATH 来源并不完全相同。