插件更新后软链接失效是因为VSCode启动时仅加载~/.zprofile，若PATH或nvm初始化留在~/.zshrc中，插件子进程就无法访问$(npm config get prefix)/bin路径；需将相关配置移至~/.zprofile、设terminal.integrated.shellArgs.osx为["-l"]、重载Shell环境并重启窗口。
插件更新后软链接失效，不是插件坏了，而是 VSCode 启动时加载的 Node 环境 PATH 和全局命令路径脱节了——尤其在 macOS + Zsh + nvm/pnpm 组合下高频发生。
为什么插件更新后 pnpm/node 命令突然找不到
插件（比如 TypeScript 官方语言服务、Prettier、ESLint）更新后常触发重新初始化 Node 子进程，此时它会读取当前终端的 PATH 来定位 node、pnpm 或 tsc。但 VSCode GUI 启动时只读 ~/.zprofile，不读 ~/.zshrc；如果你把 export PATH=... 或 nvm.sh 初始化逻辑留在 ~/.zshrc 里，插件启动的子进程就根本看不到 $(npm config get prefix)/bin 路径。
- 典型现象：
which pnpm在 VSCode 终端里有输出，但插件报错 “Cannot find module 'pnpm'” 或调试器启动卡在 “Resolving node modules…” - 验证方式：在 VSCode 终端运行
echo $PATH，对比系统终端输出 —— 如果少了~/Library/pnpm/bin或~/.npm-global/bin，就是 PATH 没加载全 - 别只看终端能用：终端能跑
pnpm --version，不代表插件子进程也能访问同一套环境
检查软链接是否真被写进正确的 prefix/bin 目录
npm 全局安装命令（如 npm install -g pnpm）实际把可执行文件软链到 $(npm config get prefix)/bin 下，而这个 prefix 会随 Node 版本切换动态变化。nvm 切换版本后，旧版本的 prefix 不会自动继承新版本的软链接。
- 先确认当前生效的 Node 版本：
node -v（必须是终端已显示Now using node v20.15.0后的结果） - 再查对应 prefix：
npm config get prefix，输出类似/Users/xxx/.nvm/versions/node/v20.15.0 - 检查软链接是否存在：
ls -la $(npm config get prefix)/bin/pnpm—— 若报 “No such file”，说明你是在旧 Node 版本下装的 pnpm - 补救：确保终端已激活目标 Node 版本，再执行
npm install -g pnpm
VSCode 插件调用 Node 时绕过软链接污染
某些插件（尤其是调试器、TypeScript 语言服务）会主动调用 fs.realpathSync() 解析 node 可执行文件路径，一旦遇到软链接循环（比如 node → /usr/local/bin/node → ... → node），就会卡死或崩溃，表现为“正在启动调试器…”无限挂起。
- 验证是否是软链接问题：
/usr/local/bin/node --version（用绝对路径绕过 shell 查找）—— 如果它能立刻返回，而node --version卡住，基本坐实 - 在
launch.json中强制指定运行时："runtimeExecutable": "/usr/local/bin/node"，避免插件自动查找被污染的node - 排查循环链：
find ~/.nvm/versions/node -type l -ls | grep -E "(node|bin)"，重点看是否有双向指向（如v20.10.0/bin/node -> ../v20.15.0/bin/node）
插件更新后必须重载 Shell 环境，不能只开新终端 tab
VSCode 启动时固化了当时的 PATH 环境变量，后续你在终端里 npm install -g 新增的软链接，不会自动注入到已存在的插件子进程中。
- 不要点「+」新建终端 tab —— 它复用旧进程，PATH 不刷新
- 正确做法：
Ctrl+Shift+P→ 输入Terminal: Reload Shell Environment，强制重读~/.zprofile - 或者彻底关闭当前终端 tab，再按
Ctrl+`新建一个 —— 新进程会完整走 login shell 流程 - 对插件生效：重载后，重启 VSCode 窗口（
Developer: Reload Window），让 Extension Host 重新加载环境
最易被忽略的是：改完 ~/.zprofile 后没退出所有 VSCode 进程，或没确认 nvm use 是否真在当前终端生效 —— 插件看到的永远是 VSCode 启动那一刻的环境快照，不是你后来在终端里手动改出来的状态。
