VSCode终端能运行node但npm报“无法识别”是因为全局bin路径未加入PATH。需根据系统将npm prefix下的bin路径（macOS/Linux）或npm prefix本身（Windows）添加到VSCode环境变量中，并彻底退出重开生效。
VSCode终端能跑node但npm命令报“无法识别”
这不是npm没装，是全局bin路径根本没进PATH。npm全局安装的命令（比如pnpm、serve）都放在npm config get prefix返回路径下的bin目录里，而VSCode启动时没加载这个路径。
- macOS/Linux：运行
npm config get prefix，结果拼/bin（如/usr/local/bin或~/.npm-global/bin），确认该路径是否出现在VSCode终端的echo $PATH输出中 - Windows：运行
npm config get prefix，典型输出是C:UsersXXXAppDataRoaming pm——这个路径本身就要加进系统环境变量的PATH，不是加bin子目录 - 别只改
~/.zshrc就以为完事：GUI启动的VSCode不读它；必须在VSCode设置里显式补全，例如"terminal.integrated.env.osx"或"terminal.integrated.env.windows" - Windows注意分隔符：
"PATH": "${env:PATH};C:\Users\XXX\AppData\Roaming\npm"，;不能写成:，且${env:PATH}必须保留
launch.json调试时提示“找不到node二进制文件”
终端能用node ≠ 调试器能用node。VSCode调试器启动的是干净进程，完全不继承终端的PATH，除非你手动喂进去。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
-
launch.json里不能用已弃用的environment字段，必须用env： -
"env": { "PATH": "${env:PATH}:/usr/local/bin" }（macOS/Linux） -
"env": { "PATH": "${env:PATH};C:\Program Files\nodejs" }（Windows） - 路径要写Node.js真实安装目录，不是npm prefix路径
- 如果项目用了
nvm或nvm-windows，调试器无法自动切换版本，建议在launch.json里硬编码runtimeExecutable指向具体node可执行文件路径
用了nvm后VSCode里node版本不对或npm直接消失
nvm靠shell初始化脚本动态改PATH，但VSCode GUI启动时跳过整个流程，导致nvm命令不可用，node和npm可能指向系统默认旧版，甚至完全失效。
- macOS/Linux：把
nvm初始化代码从~/.zshrc挪到~/.zprofile（GUI应用只读这个），并确保launchctl setenv PATH "$PATH"已执行 - 检查
~/.zshrc开头是否有[[ -n $ZSH_EVAL_CONTEXT ]] && return——它会让VSCode直接跳过后续所有export，临时加echo "zshrc loaded"验证是否真被读取 - Windows +
nvm-windows：别依赖自动PATH注入，在VSCode设置里硬编码，例如"terminal.integrated.env.windows": { "PATH": "D:\nvm4w\nodejs;${env:PATH}" } - 最简验证法：关掉所有VSCode窗口，用系统终端执行
code .启动——这时它继承当前shell的完整PATH，立刻生效
改了环境变量但重启VSCode后仍不生效
VSCode不会热更新环境变量，很多“重启”只是关窗口，后台进程还在，PATH缓存根本没刷新。
- macOS：右键Dock图标 → 「退出」，不能只关窗口；或用Activity Monitor杀掉所有
Code Helper进程 - Windows：任务管理器 → 结束所有
Code.exe进程，不只是主窗口 - 改完
terminal.integrated.shellArgs为["-l"]后，必须关闭所有已打开的集成终端面板（不只是标签页），再按Ctrl+`新建一个 - 修改系统环境变量后，VSCode必须彻底退出重开；仅靠
Reload Window无效 - Windows用户特别注意：若以管理员身份运行VSCode，它会继承系统级PATH而非当前用户PATH，导致
%APPDATA% pm等路径丢失
