根本原因是VSCode终端未加载shell配置导致PATH缺失npx路径；需通过source配置文件临时修复，或在settings中手动补全PATH，任务中用"shell"类型并加-p参数确保本地包优先。
VSCode终端里npx报command not found怎么办
根本原因是 VSCode 启动时没加载你的 shell 配置文件（比如 ~/.zshrc），导致 $PATH 缺少 $(npm config get prefix)/bin ——也就是 npx 实际所在路径。
验证：在 VSCode 终端里运行 which npx，如果返回空或报错，就确认是这个问题。
- 临时解决：先执行
source ~/.zshrc（macOS/Linux）或source ~/.bash_profile，再试npx --version - 永久解决：打开 VSCode 设置（
settings.json），加这段（注意替换为你自己的 npm prefix 路径）："terminal.integrated.env.osx": { "PATH": "/opt/homebrew/bin:/usr/local/bin:$(npm config get prefix)/bin:${env:PATH}" } - 别只写
$(npm config get prefix)，必须带/bin；运行npm config get prefix看实际值，常见是/opt/homebrew/lib/node_modules或/usr/local/lib/node_modules
tasks.json里用npx跑prettier/eslint等工具总失败
不是包没装，而是任务环境没继承完整 PATH，或者新版 npx 默认不查全局包——它只找当前项目 node_modules/.bin，找不到就静默退出，不报错。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 务必设
"type": "shell"，别用"process"；"shell"才能读取终端环境变量 - 如果目标包不在当前项目里（比如想全局用
prettier），加-p参数强制安装：["-p", "prettier", "prettier", "--write", "${file}"] -
"panel": "shared"很关键，否则每次运行都开新终端面板，PATH 又可能重置 - 别在 task 里写
sh -c "npx prettier..."，多一层 shell 容易丢环境
想用npx临时切Node版本，但在VSCode里执行不了
npx node@16 -v 这类命令在 VSCode 终端里失败，通常不是 Node 版本问题，而是 npx 下载二进制时被权限或网络策略拦截，或缓存目录不可写。
- 先手动触发一次下载：
npx node@16 -e "console.log('ok')"，看是否卡在 “Installing node@16…” - 失败时检查
npx缓存位置：npx --cache，确认该路径有写权限（尤其 macOS 的/tmp受 SIP 限制时） - CI/CD 或受限环境建议改用
npx -y node@16（-y跳过确认），避免交互阻塞 - VSCode 任务中慎用
npx node@xx做构建步骤——它依赖网络且首次执行慢，更适合本地调试
npx执行GitHub仓库脚本时路径解析出错
像 npx github:piuccio/cowsay 这种写法在 VSCode 终端里常报 Cannot find module，本质是 npx 对 Git URL 的解析逻辑和当前工作目录、package.json 里的 engines 字段强耦合。
- 确保当前目录有
package.json，哪怕空的也行；否则npx可能误判为“非项目上下文”，降级处理 - Git URL 必须带协议头：
npx git+https://github.com/piuccio/cowsay.git比github:...更稳 - 如果仓库用了私有 GitHub 或需要 token，得提前配好
~/.npmrc里的//github.com/:_authToken=xxx - VSCode 任务里跑这类命令，记得加
"isBackground": false，否则输出可能被截断
真正容易被忽略的点：VSCode 的「集成终端」和「外部终端」环境不一致；你在外壳里 npx 正常，不代表它在 VSCode 里也正常——因为前者加载了全部 shell 配置，后者只加载了部分。调任何 npx 命令前，先确认 echo $PATH | grep bin 里有没有 npm prefix 的 bin 路径。
