Node命令在终端不可用会导致VSCode无法加载launch.json、tasks.json等所有依赖Node的配置；必须先修复PATH使node -v可用，再通过runtimeExecutable显式指定Node路径，并重启VSCode验证process.execPath一致性。
node 命令在终端不可用，VSCode 就没法加载任何自定义配置
所有后续配置（launch.json、tasks.json、插件行为）都依赖系统能识别 node。如果终端里执行 node -v 报错，VSCode 内置终端和调试器必然失败。
- Windows 用户检查安装时是否勾选 “Add to PATH”；没勾就重装，或手动把
C:Program Files odejs加进系统环境变量 - macOS/Linux 用户重点看
~/.zshrc或~/.bash_profile里有没有export PATH="/usr/local/bin:$PATH"（Homebrew 安装路径） - 改完环境变量后必须完全退出 VSCode（关掉所有窗口），再重新打开——它不会热更新 PATH
- 验证方式：在 VSCode 内置终端（
Ctrl+`）里直接输node -v和npm -v，两个都得有输出
用 launch.json 指定 runtimeExecutable 才算真正加载自定义 Node 环境
VSCode 默认按 PATH 找 node，但你可能有多个版本（比如 nvm 管理的 v18.17.0 和系统自带的 v16.20.2）。不显式指定，调试器很可能调用错版本，导致 import 报错、断点失效或 process.execPath 和预期不符。
- 在项目根目录建
.vscode/launch.json，配置项里加"runtimeExecutable"字段 - macOS/Linux 示例：
"runtimeExecutable": "/Users/you/.nvm/versions/node/v18.17.0/bin/node" - Windows 示例：
"runtimeExecutable": "C:\Users\you\AppData\Local\nvm\v18.17.0\node.exe" - 配完后在 JS 文件里加
console.log(process.execPath)，运行调试，对比输出路径是否和runtimeExecutable一致
tasks.json 也能加载自定义 Node，但只适用于命令行式执行
如果你只是想一键跑某个脚本（比如 node tools/build.js），又不想每次敲命令，tasks.json 比 launch.json 更轻量，且支持传参、工作目录控制。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 在
.vscode/tasks.json里写一个shell类型 task，关键字段："command": "/path/to/your/node"（绝对路径） - 用
"args": ["${file}"]可让任务默认执行当前打开的文件 - 加
"options": {"cwd": "${fileDirname}"}能确保require('./config')这类相对路径正确解析 - 别用
${workspaceFolder}当工作目录去跑单个工具脚本——容易因process.cwd()和文件位置不一致而报Cannot find module
Code Runner 插件不读 launch.json 或 tasks.json，它的“自定义”是另一套逻辑
很多人以为改了 launch.json 就能影响 Code Runner，其实不能。它走的是自己的 executorMap 配置，和调试/任务系统完全隔离。
- 想让它用特定 Node 版本，得在 VSCode 设置里搜
code-runner.executorMap，找到javascript对应项 - 改成类似：
"node /path/to/your/node --experimental-specifier-resolution=node $fileName" - 加
-r utf-8（仅 Windows）可防中文乱码："node -r utf-8 /path/to/your/node $fileName" - 但它不支持
process.stdin输入，交互式脚本必须切到终端手动跑
真正“加载自定义 Node 环境”的核心，从来不是选哪个插件或点哪个按钮，而是控制谁来执行、用哪条路径执行、以及当前工作目录在哪——这三点漏掉任一，配置就形同虚设。
