vscode不自带node.js，仅依赖系统path；node -v成功不代表vscode能调用，因终端与调试器环境变量隔离，需通过launch.json显式配置runtimeexecutable或从终端启动code .继承环境。
node -v 能打出版本号，不代表 VSCode 就能正确调用 Node；很多人的“配置成功”只是碰巧用了系统默认路径，换台电脑或重装就失效。
VSCode 没有内置 Node.js，它只依赖系统 PATH
VSCode 本身不带node，也不提供“安装 Node”的功能——所谓“VSCode 插件安装 Node”是常见误解。插件（比如 Code Runner、Node Debug）只是调用你系统里已有的 node 可执行文件。
如果 node -v 在 cmd/PowerShell 里能运行，但 VSCode 终端里报 'node' is not recognized，说明 VSCode 启动时没读到你的环境变量（尤其是 Windows 下以快捷方式启动时可能不继承用户 PATH）。
- Windows：检查是否用“以管理员身份运行”启动 VSCode（会绕过部分用户环境变量）
- macOS/Linux：VSCode 若从 Dock 或 Spotlight 启动，可能不加载 shell 的 ~/.zshrc 或 ~/.bash_profile，导致 which node 找不到
- 解决办法：从终端启动 VSCode（code 命令），确保环境变量完整继承
不走官网下载，还能怎么装 Node？
官方下载不是唯一路径，但每种方式都有明确适用场景和副作用：-
使用版本管理工具（推荐）
-
nvm-windows（Windows）：可切换多个node版本，避免全局污染；安装后需重启 VSCode 并确认终端里nvm list和node -v一致 -
nvm（macOS/Linux）：同上，但注意 VSCode 必须从 shell 启动才能识别nvm use切换的版本 -
fnm（跨平台、Rust 写的轻量替代）：启动快，兼容性好，fnm use后 VSCode 终端通常能立即识别
-
-
包管理器安装（适合开发机统一部署）
Rydberg Agent Node下载使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- Windows：用
scoop install nodejs-lts或choco install nodejs，自动配置 PATH，但升级需手动运行命令 - macOS：
brew install node，PATH 通常没问题，但注意 Homebrew 默认装在/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel），VSCode 终端得能访问该路径 - Linux（Ubuntu/Debian）：
curl -fsSL @#@#@#@#@#@#@#@#@#@0 | sudo -E bash - && sudo apt-get install -y nodejs，比apt install nodejs版本新
- Windows：用
-
离线部署（内网/无网环境）
- 下载
.zip或.tar.xz二进制包（非安装器），解压到固定路径（如D:\tools\node-v20.15.0），然后手动把该路径加进系统 PATH - 必须同步设置 npm 全局路径：
npm config set prefix "D:\tools\node-global"，否则npm install -g会失败或写到权限受限目录
- 下载
VSCode 终端里 node 找得到，但调试器（F5）却报错
这是最常被忽略的环节：VSCode 调试器（Debug）和集成终端（Terminal）读取环境变量的机制不同。 - 终端靠 shell 初始化脚本（.zshrc 等），调试器靠 launch.json 中的 env 或系统级 PATH
- 如果你用 nvm 或 fnm，调试器默认不知道你当前用了哪个版本
- 解决方法：在 .vscode/launch.json 里显式指定 runtimeExecutable
{
"version": "0.2.0",
"configurations": [
{
"type": "pwa-node",
"request": "launch",
"name": "Launch Program",
"runtimeExecutable": "/Users/you/.fnm/node-versions/v20.15.0/installation/bin/node",
"program": "${file}"
}
]
}
- 更稳妥的做法：用 which node（macOS/Linux）或 where node（Windows）查出实际路径，填进去，避免版本漂移
真正麻烦的从来不是“怎么装”，而是“谁在什么时候、用什么方式调用它”。路径、shell 初始化、VSCode 启动方式、调试器配置，四者稍有不匹配，node 就会消失。
