如何在 VSCode 中结合 Node 环境编写第一个 API 接口-VSCode-PHP中文网

express是最直接的node.js web框架选择，需初始化package.json、安装express、启用express.json()和express.urlencoded()中间件以支持json数据，再通过app.listen()启动服务。

如何在 vscode 中结合 node 环境编写第一个 api 接口

express 是最直接的选择，不用纠结框架选型。Node 原生 http 模块也能跑，但路由、JSON 解析、错误处理都得手写，实际项目里没人这么干。

创建项目并初始化 `package.json`

别跳过这步——不是仪式感，是后续所有依赖和脚本的基础。

在 VSCode 中新建文件夹（比如叫 my-api），右键 → “在终端中打开”
运行 npm init -y，生成最小可用的 package.json
检查生成的 package.json 里是否有 "type": "commonjs" 字段；没有就手动加上，避免 import 报错（Node 默认不支持 ES 模块）

安装并使用 `express` 快速启动服务

express 不是黑盒，它本质就是一个函数：调用 express() 返回一个 app 对象，你往上面挂路由、中间件，最后用 app.listen() 启动。

Rydberg Agent Node

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

下载

执行 npm install express（不用加 --save，npm 7+ 默认保存到 dependencies）

新建 server.js，写入基础代码：

const express = require('express');
const app = express();
const PORT = 3000;

app.get('/', (req, res) => {
  res.send('Hello, API is running');
});

app.listen(PORT, () => {
  console.log(`Server listening on http://localhost:${PORT}`);
});

终端运行 node server.js，浏览器访问 http://localhost:3000 就能看见响应

让 API 能接收和返回 JSON 数据

前端发 POST 请求带 JSON body？默认情况下 express 会把 body 当作原始字符串，req.body 是 undefined——这是新手最常卡住的地方。

必须显式启用两个中间件：express.json() 和 express.urlencoded({ extended: true })
它们要放在所有路由定义之前，顺序不能错

示例：

app.use(express.json());
app.use(express.urlencoded({ extended: true }));

app.post('/user', (req, res) => {
  console.log(req.body); // 现在能正确拿到 { name: 'Alice', age: 25 }
  res.json({ success: true, data: req.body });
});

调试时别忽略端口冲突和控制台输出

VSCode 终端里反复看到 EADDRINUSE 错误？或者改了代码没反应？多半是旧进程没关干净。

每次修改 server.js 后，先按 Ctrl+C 停掉正在运行的 node 进程，再重新 node server.js
不要靠刷新浏览器判断是否生效——看终端有没有打印 Server listening on... 这行日志
如果想自动重启，临时装个 nodemon：npm install -D nodemon，然后用 npx nodemon server.js 替代 node