根本原因是VSCode终端启动时PATH已固化，未包含npm全局bin路径；需通过terminal.integrated.env.windows或osx显式注入prefix/bin路径并重启VSCode生效。
npm install -g 后 VSCode 终端仍找不到命令
根本不是安装失败，是 VSCode 终端进程没加载 npm 全局 bin 路径。npm 全局安装的可执行文件（如 pnpm、serve、tsc）默认放在 npm config get prefix 返回路径下的 bin 子目录里，但 VSCode 启动时 PATH 已固化，后续新增路径不会自动生效。
- 先验证：在 VSCode 终端运行
npm config get prefix，再拼出完整 bin 路径（macOS/Linux 是$HOME/.npm-global/bin或/usr/local/bin；Windows 是C:UsersXXXAppDataRoaming pm） - 对比系统终端（如 Terminal/iTerm/PowerShell）里的
echo $PATH或echo %PATH%，确认该 bin 路径是否缺失 - 别只改
~/.zshrc或注册表——GUI 启动的 VSCode 不读这些，必须显式注入 - Windows 用户在 VSCode 设置 JSON 中加：
"terminal.integrated.env.windows": { "PATH": "${env:PATH};C:\Users\XXX\AppData\Roaming\npm" }（注意双反斜杠或正斜杠） - macOS/Linux 用户用：
"terminal.integrated.env.osx": { "PATH": "${env:PATH}:/usr/local/bin" }或对应你自己的prefix+/bin
项目 preinstall 脚本报 “command not found”
这类脚本（比如 "preinstall": "pnpm --version"）在 VSCode 集成终端里执行时，依赖的是终端环境，不是 Node.js 运行时本身。如果 pnpm 或 typescript 等全局命令不可见，脚本直接中断，不进后续逻辑。
- 检查
package.json里调用的命令是否真为全局安装——pnpm不等于npx pnpm，后者走本地 node_modules/.bin，前者必须 PATH 可达 - 不要在
preinstall里写npm install -g pnpm：VSCode 终端可能连npm都没识别，更别说执行它 - 若必须用全局工具，建议改用
npx显式调用，例如"preinstall": "npx pnpm --version"，避免 PATH 依赖 - CI/CD 或本地手动跑
npm install时没问题，但 VSCode 里失败？大概率是终端 PATH 和 shell 环境不一致，不是项目配置问题
nvm 切换后 VSCode 终端 node/npm 版本错乱
nvm 本质是靠修改 PATH 动态指向不同 Node 版本，但它初始化逻辑（如 source ~/.nvm/nvm.sh）只在 shell 启动时执行。VSCode GUI 启动时跳过这步，导致 node 指向旧版、npm 根本不可用，甚至报 command not found。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- macOS/Linux：把 nvm 初始化代码从
~/.zshrc移到~/.zprofile（GUI 应用只读这个），并确保launchctl setenv PATH "$PATH"已执行 - Windows + nvm-windows：别信“自动切换”，每次
nvm use后，必须在 VSCode 里按Ctrl+Shift+P→ 输入Terminal: Reload Shell Environment，或关掉终端 tab 重开 - 验证方式：在 VSCode 终端里分别运行
which node和node -v，输出路径必须匹配当前 nvm 激活版本的安装目录 - 如果
nvm current显示 v18.20.2，但node -v输出 v16.20.2，说明 PATH 没刷新，nvm 没生效
launch.json 调试时提示 “找不到 Node.js 二进制文件 'node'”
这是最易被误判的场景：终端能跑 node -v，但 F5 调试就崩。因为调试器启动的是全新进程，完全不继承终端环境变量，它的 PATH 是空的，除非你手动喂。
-
launch.json里不能用environment字段（已弃用），必须用env： - macOS/Linux 示例：
"env": { "PATH": "${env:PATH}:/usr/local/bin" } - Windows 示例：
"env": { "PATH": "${env:PATH};C:\Program Files\nodejs" } - 路径分隔符严格区分：Linux/macOS 用
:，Windows 用;，写错一个字符就失效 - 别指望
runtimeExecutable能绕过 PATH —— 它只指定 node 可执行文件位置，但调试器仍需从 PATH 找 npm、tsc 等配套工具
真正麻烦的从来不是装错软件，而是 PATH 在不同上下文（GUI 启动、shell 登录、调试进程）里被反复切片、覆盖、忽略。每个环节都得单独喂，不能指望“一次配置，处处生效”。
