解决VSCode终端在Mac系统因Zsh配置引发的Node全局命令软链接失效-VSCode-PHP中文网

vscode终端找不到全局npm命令是因为gui启动时不读取~/.zshrc，需将path相关配置移至~/.zprofile并设terminal.integrated.shellargs.osx为["-l"]，再重载终端环境。

解决vscode终端在mac系统因zsh配置引发的node全局命令软链接失效

为什么 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。