vscode多根工作区中node命令找不到，根本原因是调试器和任务启动的是干净进程，不继承终端path，必须在launch.json和tasks.json中通过env字段显式拼接path；各子文件夹需独立配置.vscode/settings.json，且program必须指向真实js文件路径，而非ts或源码。
VSCode多根工作区里Node命令找不到？PATH没继承到调试器
终端能跑node -v ≠ 调试器和构建任务能用node。多根工作区下，每个文件夹可能有独立的Node版本或路径，但VSCode的launch.json和tasks.json启动的是干净进程，PATH默认为空。
必须显式补全PATH，不能依赖终端环境：
-
launch.json中用env字段拼接："env": { "PATH": "${env:PATH}:/opt/homebrew/bin" }（macOS）或"PATH": "${env:PATH};C:\Program Files\nodejs"（Windows） -
tasks.json同理，在options.env里写相同逻辑 - 别用
environment（已弃用），也别写runtimeExecutable指向npm——它不支持断点注入
不同文件夹要用不同Node版本？别指望全局PATH自动切换
VSCode本身不管理Node版本切换，.code-workspace里的settings是全局生效的，无法按文件夹区分node路径。真正起作用的是各子文件夹下的.vscode/settings.json，配合语言扩展行为。
实操要点：
- 在
backend/.vscode/settings.json里写："node.debug.port": 9229这类调试相关项，但node可执行路径仍需靠env传入 - 若用
nvm或nvm-windows，确保每个文件夹的.nvmrc或.node-version被对应扩展识别（如NVM for Windows Extension） - Windows下
nvm-windows安装路径不在默认PATH时，必须手动加到terminal.integrated.env.windows或每个env字段里
.code-workspace里folders路径写错，Node环境直接“失联”
路径错误不会报错，但会导致对应文件夹的.vscode配置完全不加载——包括settings.json和launch.json，自然也就没有Node环境适配。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
检查重点：
- 所有
path字段必须统一用相对路径或绝对路径，不能混用："path": "api"和"path": "/home/user/app/web"共存会静默失败 - 路径末尾不要加
/，"path": "api/"会被VSCode忽略 - 右键状态栏确认显示
workspace（蓝色图标），不是folder；否则.code-workspace根本没激活 - 打开开发者工具，运行
vscode.workspace.workspaceFolders，返回数组长度必须≥2且每项uri不为空
为什么改了.vscode/settings.json，Node调试还是报“找不到二进制文件”？
这个错误几乎只发生在launch.json的program字段指向了非JS文件，比如.ts、.mjs或未编译的源码路径。VSCode调试器只认可执行的JS文件，不负责编译或转译。
关键判断点：
-
program必须是真实存在的JS文件路径，例如"${workspaceFolder}/dist/index.js"，不是src/index.ts - TypeScript项目：确保
tsconfig.json里"sourceMap": true，且.map文件与.js同目录 - ESM项目（
"type": "module"）：保留program为JS路径，但加runtimeArgs：["--experimental-specifier-resolution=node"] - 别把
package.json的"main"当program——它只是模块入口，不是调试入口
最常被忽略的一点：多根工作区里，launch.json放在哪个文件夹的.vscode下，就只对那个文件夹生效；跨文件夹调试必须用cwd和program组合指向目标路径，而不是指望“全局Node环境”自动适配。
