能直接跑起来的前提是node命令在终端中可识别，否则所有操作都会卡在第一步；需检查Node.js是否安装并加入PATH，验证用node -v，失败则重装并勾选“Add to PATH”，重启VSCode，避免中文路径，再通过hello.js和server.js分别验证JS执行与模块加载能力。
能直接跑起来，前提是 node 命令在终端里能识别。否则所有操作都会卡在第一步。
检查 Node.js 是否已安装并可用
VSCode 本身不带运行环境，node 必须提前装好且进入系统 PATH。打开 VSCode 内置终端（Ctrl + `），输入：
node -v
如果返回类似 v20.15.0 的版本号，说明没问题；如果报错 'node' is not recognized as an internal or external command，那就得先解决环境变量问题：
- 重新运行 Node.js 安装程序，勾选 “Add to PATH”（Windows MSI 版默认勾选，ZIP 版需手动配置）
- 安装后必须重启 VSCode——不是关掉终端，是彻底退出再打开
- 确认安装路径不含中文或空格（比如
C:\Program Files\nodejs\比C:\我的软件\nodejs\更稳妥）
创建并运行最简 hello.js
不用新建文件夹、不用初始化 package.json，直接写个单文件就能验证环境是否通：
- 在 VSCode 中新建文件，保存为
hello.js（扩展名不能漏） - 内容只写一行：
console.log("Hello World"); - 在终端中执行：
node hello.js
看到输出即表示 JS 运行时工作正常。注意：不要用右键“在终端中运行代码”之类插件快捷方式——初期容易掩盖路径或权限问题，坚持手敲 node 命令更可控。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
启动一个 HTTP 服务器（验证模块加载能力）
console.log 只测 JS 执行，真正体现 Node.js 特性的是内置模块调用。新建 server.js：
const http = require('http');
const server = http.createServer((req, res) => {
res.writeHead(200, { 'Content-Type': 'text/plain' });
res.end('Hello World from Node.js\n');
});
server.listen(3000, () => console.log('Server running at http://localhost:3000/'));
运行 node server.js 后，终端会打印监听地址。这时打开浏览器访问 http://localhost:3000/：
- 如果页面显示文字，说明
require('http')成功，网络模块可用 - 如果报错
Error: listen EADDRINUSE :::3000，说明端口被占，改用server.listen(4000, ...)即可 - 别用
80或443端口——Windows 下需要管理员权限，徒增干扰
常见失败点：插件和调试配置的误导
很多教程推荐装 Code Runner 插件一键运行，但它默认用 node 调用当前文件，不校验工作目录，也不暴露错误堆栈。一旦出错，你只看到红字一闪而过：
- 首次调试建议禁用 Code Runner，纯靠终端命令 +
console.log定位 - 如果要用 F5 调试，必须先生成
.vscode/launch.json（按Ctrl+Shift+P→ “Debug: Open launch.json” → 选 Node.js），否则会提示Can't find Node.js binary "node" -
launch.json里的runtimeExecutable字段极少需要改——只要node -v在终端有效，这里就不用动
真正卡住人的，往往不是语法或逻辑，而是 node 命令在哪、当前目录对不对、端口有没有被占——这些细节不显眼，但一步错，全盘停。
