Express 快速搭建 Web 服务

用 Express 框架轻松创建 REST API，处理路由、请求参数、中间件 · 难度：进阶 · +25XP

Express 是什么？

Express 是 Node.js 最流行的 Web 框架。它让创建 API 接口变得非常简单——原本用 http 模块需要几十行代码的功能，Express 几行就搞定了。

安装 Express

npm install express

第一个 Express 服务器

const express = require("express");
const app = express();
const PORT = 3000;
// 定义路由：GET / 请求时返回 JSON
app.get("/", (req, res) => {
  res.json({ message: "你好，Express！" });
});
// GET /users 返回用户列表
app.get("/users", (req, res) => {
  res.json([
    { id: 1, name: "张三" },
    { id: 2, name: "李四" }
  ]);
});
app.listen(PORT, () => {
  console.log(服务运行在 http://localhost:${PORT});
});

处理不同的 HTTP 方法

app.get("/api/items", (req, res) => { ... });      // 查询
app.post("/api/items", (req, res) => { ... });     // 创建
app.put("/api/items/:id", (req, res) => { ... });  // 更新
app.delete("/api/items/:id", (req, res) => { ... }); // 删除

Url 参数和查询参数

// 路径参数: /users/123
app.get("/users/:id", (req, res) => {
  const userId = req.params.id;   // "123"
  res.json({ id: userId });
});
// 查询参数: /search?keyword=vue&page=2
app.get("/search", (req, res) => {
  const keyword = req.query.keyword;  // "vue"
  const page = req.query.page;        // "2"
  res.json({ keyword, page });
});

回顾：Express 封装了 http 模块。你不需要手动写 createServer、解析 URL 路径、设置响应头这些底层代码——Express 帮你做好了。

动手试试

1. 创建一个 GET /api/time 路由，返回当前服务器时间
2. 创建一个 POST /api/echo 路由，返回客户端发来的数据
3. 使用路径参数，创建一个 /api/greet/:name 路由