vscode调试器报“cannot find runtime 'node'”的根本原因是其不继承终端环境变量，必须在launch.json中显式配置runtimeexecutable字段指向fnm或nvm安装的具体node二进制文件（如windows下"d: vm4w odejs ode.exe"），而非依赖path或写"node"。
VSCode 找不到 node，不是 VSCode 有问题，而是它压根没拿到你系统里那个能跑 node -v 的路径——终端能用 ≠ 调试器能用 ≠ 任务能用 ≠ GUI 启动时能继承。
为什么终端能 node -v，但调试器报 “Cannot find runtime 'node'”
VSCode 的调试器（launch.json）启动的是干净进程，不继承终端环境变量。哪怕你在 PowerShell 里执行过 $env:Path += ";D:
vm4w
odejs"，调试器也完全看不见。
- 验证方式：在 VSCode 终端运行
echo $PATH，再打开 Debug Console 输入process.env.PATH，两者输出通常不一致 - 根本解法不是改 shell，而是让
launch.json显式喂路径："runtimeExecutable": "D:\nvm4w\nodejs\node.exe" - 别写
"env": { "PATH": "..." }—— 这个字段对调试器无效；env只影响程序运行时环境，不改变node自身的查找逻辑 - Windows 路径必须用双反斜杠
\或正斜杠/，单反斜杠会被 JSON 解析为转义符
terminal.integrated.env.windows 怎么填才生效
这个设置只影响新建的集成终端（Ctrl+`），且必须重启 VSCode 才加载——改完保存后关掉所有窗口，再重新打开，否则还是旧 PATH。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 正确写法：
"terminal.integrated.env.windows": { "PATH": "${env:PATH};D:\nvm4w\nodejs" } -
${env:PATH}必须保留，否则连notepad、ping都会失效 - 不能写成
"PATH": "D:\nvm4w\nodejs;%PATH%"——%PATH%是 CMD 语法，PowerShell 不认 - 如果用了 nvm-windows，建议顺手加
"terminal.integrated.defaultProfile.windows": "PowerShell"，避免 CMD 和 PowerShell PATH 不同步
macOS/Linux 用户别信“重启窗口”，要从终端启动 VSCode
双击 Dock 图标或 Launchpad 启动的 VSCode 是 non-login shell，跳过 ~/.zshrc 里的 export PATH=...，所以 which node 在终端里有，在 VSCode 终端里就空。
- 临时验证：在系统终端执行
code .，再开终端输node -v—— 如果这时好了，就是启动方式问题 - 永久解法：把
shellArgs设为["-l"]（小写 L），强制走 login 流程："terminal.integrated.shellArgs.osx": ["-l"] - 注意检查
~/.zshrc开头有没有[[ -n $ZSH_EVAL_CONTEXT ]] && return这类防护逻辑，它会让文件提前退出；加一句echo "zshrc loaded"就能确认是否真被读取 - 别在
~/.zprofile里重复 export PATH，zsh 默认不读它，除非你手动配置了
program 字段写错是断点不生效的头号原因
program 是调试器唯一依赖的入口路径，写错一个字符、少一个变量、指错编译产物，断点就永远是空心圈。
- 单文件脚本用
"program": "${file}"—— 别写成"./${fileBasename}"，.在这里不解析 - TypeScript 项目必须指向
.js文件，比如"${workspaceFolder}/dist/server.js"；写src/server.ts一定失败 - ESM 项目需同时满足：
package.json有"type": "module"，且launch.json中"runtimeArgs"加上--loader ts-node/esm（若用 ts-node） - 路径里含空格或中文？直接报错，别挣扎 —— 重装 Node.js 到
C: odejs或/usr/local/bin这类干净路径
最常被忽略的一点：runtimeExecutable 和 program 是两套独立路径系统，前者决定用哪个 node 二进制，后者决定跑哪个 JS 文件；改了一个，另一个可能还在用旧版本或错误路径，得一起核对。
