环境真正可用的标准是能运行 node 命令且 VSCode F5 可断点调试；首要验证 node -v 和 npm -v 在系统终端输出版本号，路径不含中文/空格，环境变量生效后需重启 VSCode，再通过 hello.js 验证执行与调试。

能跑 node 命令，且在 VSCode 里按 F5 能断点调试，才算环境真正可用；其余插件、格式化、package.json 初始化，全是后续动作，不是启动门槛。

node -v 报错？先别碰 VSCode

这是最常卡住的环节，90% 的“VSCode 跑不起来”本质是系统没认出 node。必须在系统终端（Windows 是 CMD/PowerShell，macOS/Linux 是 Terminal）里执行：

• node -v 和 npm -v 都得输出版本号，缺一不可
• Windows 安装时漏勾 Add to PATH，或装在 C:我的软件 odejs 这类含中文/空格路径，npm 可能静默失败
• macOS/Linux 用 nvm 的，确认 source ~/.nvm/nvm.sh 已写入 ~/.zshrc 或 ~/.bash_profile，且新开终端已加载
• 改完环境变量后，必须彻底退出 VSCode 再重开，内置终端不会自动刷新 PATH

直接运行 hello.js，别急着 npm init

验证 JS 运行时是否通，不需要项目结构、不需要 package.json。三步搞定：

• VSCode 新建文件 → 输入 console.log("Hello World"); → 保存为 hello.js（扩展名不能丢）
• 用快捷键 Ctrl + `（反引号）唤出 VSCode 内置终端
• 确保终端当前路径是 hello.js 所在目录（可用 cd 切换），再执行 node hello.js

看到输出即说明 node 可执行、路径正确、文件编码无 BOM —— 此时才值得继续往下走。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

调试要设断点，不是点“运行”

VSCode 自带 Node.js 调试支持，无需装 Node.js Extension Pack 或 Debugger for Node.js，装了反而可能冲突。

• 打开 hello.js，在 console.log 行号左侧单击设断点（红点出现）
• Ctrl + Shift + P → 输入 Debug: Open Configuration → 选 Node.js → Current File
• VSCode 自动生成 .vscode/launch.json，关键字段是 "program": "${file}"
• 按 F5 启动，程序会在断点暂停；若提示 Cannot find runtime 'node'，一定是前面 node -v 没过，不是配置问题

runtimeExecutable 不写，多版本环境下必踩坑

如果你用 nvm 或手动装了多个 Node 版本，VSCode 默认按 PATH 顺序找 node，但终端里 which node 输出的路径，和调试器实际调用的可能不一样。

• 在项目根目录的 .vscode/launch.json 中，给配置加一行："runtimeExecutable": "/usr/local/bin/node"（macOS/Linux）或 "runtimeExecutable": "C:\Program Files\nodejs\node.exe"（Windows）
• 在代码里加一句 console.log(process.execPath)，对比终端输出和调试器输出是否一致
• 不显式指定时，node -v 和调试器用的 node 版本可能不同，导致 import 报错、fs.promises 不可用等隐蔽问题

真正麻烦的从来不是“怎么写第一行代码”，而是 node 命令在哪、被谁调用、用的是哪个版本——这些细节不钉死，后面所有调试、模块加载、ESM 切换都会飘。