根本原因是Node.js未加入系统PATH或VSCode未读取更新后的环境变量；需将解压路径（如D: odejs）添加至系统Path，重启VSCode与终端，并在launch.json中配置绝对路径的runtimeExecutable。
离线安装Node.js二进制包后，VSCode仍报“node : 无法识别为命令”
根本原因不是VSCode没装插件，而是node可执行文件没进系统PATH，或VSCode没读到更新后的环境变量。离线安装的Node通常解压即用，但不会自动写入环境变量。
- 确认Node解压路径不含空格和中文（例如
D: odejs，不要用C:Program Files odejs） - 手动把
D: odejs（替换成你的真实路径）加进系统环境变量Path——注意是「系统变量」里的Path，不是用户变量 - 关闭所有VSCode窗口，再重新打开；如果已打开终端，需重启终端面板（Ctrl+Shift+P →
Terminal: Kill Terminal，再新建） - 在VSCode终端里直接运行
where node（Windows）或which node（WSL），看是否返回你解压的路径
VSCode调试时提示“Cannot find runtime 'node' on PATH”
这是launch.json里runtimeExecutable没指向离线Node导致的。默认调试配置会查系统PATH里的node，但离线部署时它可能不在标准位置。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 在项目根目录下创建
.vscode/launch.json，确保configurations中包含：
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Launch Program",
"program": "${file}",
"runtimeExecutable": "D:\nodejs\node.exe"
}
]
}
-
runtimeExecutable必须是绝对路径，且指向node.exe（不是文件夹） - 路径中的反斜杠
要双写（\），否则JSON解析失败 - 如果用WSL或Git Bash终端调试，
runtimeExecutable得换成Linux路径格式，比如/mnt/d/nodejs/node
离线环境下npm全局模块安装失败或找不到命令
离线Node自带npm，但默认全局路径在C盘（如C:UsersXXXAppDataRoaming
pm），权限受限且易被杀毒软件拦截。不改路径，npm install -g大概率失败。
- 在Node解压目录下新建两个文件夹：
node_global和node_cache - 以管理员身份打开CMD，执行：
npm config set prefix "D:\nodejs\node_global" npm config set cache "D:\nodejs\node_cache"
- 把
D:\nodejs\node_global也加进系统Path环境变量（和node.exe路径并列） - 验证：运行
npm list -g --depth=0，应能列出已安装的全局包；运行cnpm或vue等命令不报“不是内部命令”
离线Node调试时断点不生效或控制台无输出
常见于Node版本与VSCode调试协议不匹配，或package.json缺失必要字段。离线环境没法自动更新插件或获取源码映射，必须靠配置兜底。
- 确保Node版本不低于12.x（推荐16.x或18.x LTS），太老的版本不支持
--inspect调试协议 - 在
launch.json中显式加上"console": "integratedTerminal"，避免输出被吞掉 - 如果项目有
package.json，检查"type": "module"是否设置正确——ESM项目需加"runtimeArgs": ["--loader", "ts-node/esm"]之类参数，否则import语法会崩 - 禁用所有非必要的VSCode插件（尤其那些带网络请求的），只留
ms-vscode.vscode-typescript-next和ms-python.python这类纯本地插件
runtimeExecutable写错斜杠，或Path漏加一个分号，就卡死半天。建议每改一处，都在CMD里单独验证node -v和npm -v，再开VSCode测试，别堆在一起调。 
