VSCode终端找不到全局npm命令是因为GUI启动时不读取~/.zshrc，需将PATH相关配置移至~/.zprofile并设terminal.integrated.shellArgs.osx为["-l"]，再重载终端环境。
为什么 npm 全局安装的命令在 VSCode 终端里找不到
不是 npm install -g 失败了，是 VSCode 启动时没读取 ~/.zshrc 里的 npm config get prefix 路径拼接逻辑，导致 prefix/bin（比如 ~/Library/pnpm/bin 或 ~/.npm-global/bin）根本没进 PATH。系统终端能用，VSCode 不能，99% 是这个原因。
- 先验证：在 VSCode 终端运行
echo $PATH，再对比系统终端输出——如果少了~/Library/pnpm/bin或类似路径，就坐实了 -
npm config get prefix输出的是全局安装根目录，真实可执行文件在它下面的bin/子目录，必须手动拼上 - 别只改
~/.zshrc就以为完事：GUI 启动的 VSCode（Dock、Spotlight）不读它，只读~/.zprofile - Mac 上用
nvm的用户尤其要注意：nvm.sh和nvm use必须挪到~/.zprofile，否则npm和全局 bin 都不可见
如何让 VSCode 终端真正加载 Zsh 的完整 PATH
强制 VSCode 终端走 login shell 流程，并确保 ~/.zprofile 包含所有关键导出逻辑，比硬编码 terminal.integrated.env.osx 更可靠、更可持续。
- 把
~/.zshrc里所有影响PATH的内容（包括nvm初始化、export PATH=...、npm config get prefix拼接）全部剪切到~/.zprofile - 删掉
~/.zshrc开头可能存在的防护语句，比如[[ -n $ZSH_EVAL_CONTEXT ]] && return，否则~/.zprofile也可能被跳过 - 在 VSCode 设置中，把
terminal.integrated.shellArgs.osx设为["-l"]（小写 L），强制启动 login shell - 关掉所有 VSCode 窗口（macOS 右键 Dock → Quit），再从系统终端执行
code --no-sandbox .启动一次，确认pnpm --version或serve --version能立刻生效
避免 npm install -g 后 VSCode 终端仍不识别的缓存陷阱
VSCode 启动时固化了当时的 PATH，后续你 npm install -g pnpm 生成的新软链接，它不会自动感知——不是配置错了，是进程没刷新。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 每次全局安装新命令后，不要只点「+」新建终端 tab，要按
Ctrl+Shift+P→ 输入Terminal: Reload Shell Environment手动重载 - 或者直接关闭当前终端 tab，再按
Ctrl+`新建一个——新进程会重新读~/.zprofile和PATH - 如果用了
nvm use 20.15.0切换版本，必须等终端显示Now using node v20.15.0后再装全局包，否则软链接会写进旧版本的prefix/bin - 检查软链接是否真存在：
ls -la $(npm config get prefix)/bin，确认pnpm、typescript这些名字下有箭头指向正确位置
当 ~/.zprofile 也失效时的兜底方案
极少数情况（比如 macOS Sequoia + M4 芯片 + 自定义 Shell wrapper），连 ~/.zprofile 都不被 GUI 应用读取，就得靠 VSCode 自身环境变量注入，但必须精准控制路径拼接顺序。
- 在 VSCode 用户设置 JSON 中添加：
"terminal.integrated.env.osx": { "PATH": "/opt/homebrew/bin:$(npm config get prefix)/bin:${env:PATH}" } - 注意：路径之间用
:分隔；$(npm config get prefix)/bin必须放在${env:PATH}前面，否则旧系统路径会优先命中老版本命令 - Windows 用户别抄这个——
terminal.integrated.env.windows用;分隔，且路径中斜杠方向要统一（推荐正斜杠/） - 改完保存后，必须彻底退出 VSCode 再重开，否则
PATH不会重载
最常被忽略的一点：VSCode 终端和调试器（launch.json）用的是两套环境变量机制。你在终端里修好了 pnpm，不代表 F5 调试时 runtimeExecutable: "pnpm" 就能用——后者需要单独在 launch.json 的 env 字段里补全 PATH。
