npm run报command not found是因终端工作目录非当前子项目根且path未加载其node_modules/.bin，需用terminal: create new terminal in active workspace folder切换路径，或npx --prefix显式指定；原生模块abi不匹配则须按vscode内置node的napi_build_version重编译。
终端里 node -v 正确但 npm run 报 command not found
这不是 Node 版本错了，而是终端当前工作目录和 PATH 没对上。多根工作区下，VSCode 默认把第一个添加的文件夹设为终端初始路径，但你点的是 backend/package.json 里的 script，npm 却在 frontend 目录下执行——自然找不到 backend 的 node_modules/.bin。
- 新开终端后，先用
Ctrl+Shift+P→Terminal: Create New Terminal in Active Workspace Folder，确保 pwd 是当前焦点子项目根目录 - 别依赖
"terminal.integrated.cwd": "${workspaceFolder}"：它在多根工作区中只取第一个文件夹，不是“当前打开的” - 临时救急写法：
npx --prefix ./ vite dev（显式指定--prefix），绕过 PATH 查找逻辑
调试器断点灰掉、提示 Cannot find module './build/Release/xxx.node'
这说明原生模块 ABI 不匹配，根本原因是 VSCode 插件主机（Extension Host）和调试主进程用了不同 Node 版本。插件加载走的是 VSCode 内置 Electron 的 Node（比如 v22.4.0 + napi_build_version=9），而你本地 nvm use v20.18.0 编译出来的二进制是 napi=8。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 重编译必须带完整参数：
npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0 - 务必先删干净：
rm -rf node_modules/.pnpm node_modules/xxx/node_modules，否则旧缓存优先被 require -
launch.json里"runtimeExecutable"只控制主进程，不影响插件——所以即使它指向 v20，Prettier 或 ESLint 插件仍会用内置 v22 加载原生模块
多个项目同时开，.nvmrc 自动切换失效
.nvmrc 文件本身不被 VSCode 读取，nvm 也不会自动触发 nvm use。所谓“自动”，全靠插件或手动干预，漏一步就串版本。
- 最稳做法：每个项目根目录放
.nvmrc（内容如v18.20.4），打开后手动执行一次nvm use，再验证which node - 插件可选
vsc-nvm，但它只对新终端生效；已存在的终端需关闭重开，且不保证所有子 shell 都继承 - 硬编码
"runtimeExecutable": "/Users/x/.nvm/versions/node/v18.20.4/bin/node"在launch.json中看似省事，但换机器、重装 nvm 或同事拉代码就直接崩
跨大版本项目（如 v14 和 v22）共存时 ABI 冲突频发
Node.js 大版本间 ABI 兼容性断裂严重，尤其涉及 node-gyp、sqlite3、fsevents 这类原生模块时，靠 nvm use 切换解决不了根本问题——宿主机只有一个全局 node_modules 缓存，不同版本编译产物混在一起必然出错。
- 唯一可靠方案是
Dev Containers：每个项目用独立镜像（如node:14/node:22），自带完整 ABI 环境 - 容器内
npm install生成的.node文件只对该镜像生效，彻底隔离 - 注意
.devcontainer.json中要显式指定"features"版本，不能只写"node"，否则可能拉到默认 latest（即 v22），导致 v14 项目启动失败
launch.json，不代表 ESLint 或 Prettier 就能正常加载原生依赖。
