能直接跑起来的前提是node命令在终端中可识别,否则所有操作都会卡在第一步;需验证node -v和npm -v是否返回版本号,path未生效、路径含空格或中文会导致报错,改环境变量后必须重启vscode,推荐用内置终端手动执行node命令而非code runner。

能直接跑起来的前提是 node 命令在终端中可识别,否则所有操作都会卡在第一步。
检查 node 是否已安装并进入系统 PATH
VSCode 本身不带运行环境,node 必须提前装好且能被终端识别。打开 VSCode 内置终端(Ctrl + `),执行:
node -v
如果返回类似 v20.15.0 的版本号,说明没问题;如果报错 'node' is not recognized as an internal or external command,就要处理环境变量:
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1),免gas,支持macOS/Linux/Windows。触发词:/r
- 重新运行 Node.js 安装程序(Windows 推荐 .msi 版),务必勾选 “Add to PATH”
- ZIP 解压版需手动把解压路径(如
C:\nodejs\)加到系统PATH环境变量里 - 安装后必须彻底退出并重启 VSCode——不是只关终端,是整个应用重开
- 避免 Node.js 安装路径含中文或空格(比如
C:\Program Files\nodejs\比C:\我的软件\nodejs\更稳妥)
手写 hello.js 验证 JS 运行时是否正常
不用新建项目、不初始化 package.json,单文件就能验证核心能力:
- 在 VSCode 中新建文件,保存为
hello.js(扩展名不能漏) - 内容只写一行:
console.log("Hello World"); - 在终端中执行:
node hello.js - 看到输出即表示 JS 执行环境通了
- 别依赖 Code Runner 插件的右键“Run Code”——初期容易掩盖路径或权限问题,坚持手敲
node命令更可控
用 server.js 验证模块加载与 HTTP 服务能力
仅靠 console.log 不能说明 Node 的模块系统和网络能力是否就绪,补一个最小 HTTP 服务:
- 新建
server.js,内容如下:
const http = require('http');
const hostname = '127.0.0.1';
const port = 3000;
const server = http.createServer((req, res) => {
res.statusCode = 200;
res.setHeader('Content-Type', 'text/plain');
res.end('Hello World\n');
});
server.listen(port, hostname, () => {
console.log(`Server running at http://${hostname}:${port}/`);
});
- 终端执行:
node server.js - 浏览器访问
http://localhost:3000/,看到页面输出即说明require、内置模块、端口监听都正常 - 注意:如果提示端口被占用,改
port值即可(如3001)
真正容易被忽略的是:Node.js 安装路径里的空格或中文,会导致某些插件或调试器读取失败,而 node -v 却仍能成功——这种“半通”状态最耗时间排查。










