VSCode中Node环境的全局变量失效？教你解决-VSCode-PHP中文网

vscode终端能运行node但npm报“无法识别”是因为全局bin路径未加入path。需根据系统将npm prefix下的bin路径（macos/linux）或npm prefix本身（windows）添加到vscode环境变量中，并彻底退出重开生效。

vscode中node环境的全局变量失效？教你解决

这不是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}必须保留

终端能用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靠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不会热更新环境变量，很多“重启”只是关窗口，后台进程还在，PATH缓存根本没刷新。

macOS：右键Dock图标 → 「退出」，不能只关窗口；或用Activity Monitor杀掉所有Code Helper进程
Windows：任务管理器 → 结束所有Code.exe进程，不只是主窗口
改完terminal.integrated.shellArgs为["-l"]后，必须关闭所有已打开的集成终端面板（不只是标签页），再按Ctrl+`新建一个
修改系统环境变量后，VSCode必须彻底退出重开；仅靠Reload Window无效
Windows用户特别注意：若以管理员身份运行VSCode，它会继承系统级PATH而非当前用户PATH，导致%APPDATA% pm等路径丢失