Express 入门

这一课你将能做到

1. 用 Express 搭出带路由参数、查询参数的 REST API，并对接 Postman/curl 验证
2. 编写并正确排序中间件（含 express.json()、自定义日志、静态资源）
3. 用错误处理中间件统一兜底 404 与业务异常

为什么要学

上一课用原生 http 模块手工干了三件苦活：if-else 判断路由、监听 data 事件收 body、手动设状态码和头。请求一多代码就乱成面条。Express 人话：给 http 模块套上一层「中间件流水线 + 路由表」，把苦活变成一行行的声明。

它是 Node 生态事实上的 Web 框架标准（Koa、Fastify 的设计都绕不开它的中间件概念），学会 Express，等于同时看懂了大半 Node Web 框架的设计语言。

先建立图像

Express 的核心是「中间件流水线」：请求像传送带上的包裹，依次经过你注册的函数，每个函数可以选择处理它、修改它，或者传递给下一个：

请求 GET /api/users/42
   │
   ▼
[express.json()] ──► [我的日志中间件] ──► [路由匹配 /api/users/:id]
   │                     │                       │
 收集body            打印耗时              取出 id=42 处理
   │                     │                       │
   └────── 每个环节都能调用 next() 交给下一个 ──┘
                                  │
              出错时 → next(err) 直达错误处理中间件 → 返回 500

三条铁律先记住：中间件有顺序；不调 next 就要自己收尾响应；next(err) 会跳过中间所有环节直达错误处理。

跟着做

步骤 1：安装并起最小应用

新建 node-express 目录，npm init -y，安装：

npm install express

新建 app.js：

// app.js
const express = require('express');

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

app.get('/', (req, res) => {
  res.send('hello express');
});

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

node app.js

浏览器访问 http://localhost:3000 看到 hello express。对比原生 http 版：没有 createServer、没有手动设头，res.send 自动判断类型并设置 Content-Type、自动 end。

开发期建议顺手把 package.json 的 scripts 改成热重载：

"scripts": {
  "dev": "node --watch app.js"
}

npm run dev     # 改代码自动重启，Node 20 内置 --watch，无需 nodemon

步骤 2：路由参数与查询参数

把 CRUD 骨架补上：

// app.js（在 app.get('/') 之后追加）
const books = [
  { id: 1, title: 'Node 入门' },
  { id: 2, title: 'Express 实战' },
];

// 列表：GET /api/books?keyword=Express
app.get('/api/books', (req, res) => {
  const keyword = req.query.keyword;               // 查询参数
  const result = keyword
    ? books.filter(b => b.title.includes(keyword))
    : books;
  res.json({ data: result, total: result.length });
});

// 详情：GET /api/books/1
app.get('/api/books/:id', (req, res) => {
  const book = books.find(b => b.id === Number(req.params.id));
  if (!book) {
    return res.status(404).json({ error: '图书不存在' });
  }
  res.json(book);
});

// 创建：POST /api/books
app.post('/api/books', (req, res) => {
  const { title } = req.body ?? {};
  if (!title) {
    return res.status(400).json({ error: 'title 必填' });
  }
  const book = { id: books.length + 1, title };
  books.push(book);
  res.status(201).json(book);
});