Node.js + Express 搭建 RESTful API 实战

项目结构

src/
├── routes/       # 路由定义
├── controllers/  # 业务入口
├── services/     # 业务逻辑
├── middlewares/  # 中间件
└── app.js

统一响应格式

res.ok = (data) => res.json({ code: 0, data });
res.fail = (msg, code = 1) => res.json({ code, msg });

参数校验

用 zod 在入口处做校验，脏数据进不了业务层：

const schema = z.object({ title: z.string().min(1).max(128) });
const parsed = schema.safeParse(req.body);
if (!parsed.success) return res.fail('参数错误');

错误处理

所有同步与异步异常统一交给最后的错误中间件，避免进程崩溃。

写在最后

Express 上手快，但"快"不等于"乱"。把分层和约定定好，小项目也能长成大项目。