当前位置：首页 > news >正文

Node系列 · Express：基本使用

news 2026/8/29 18:42:03

Node系列 · Express：基本使用

Express 是 Node 生态最老牌、最流行的 Web 框架——Koa 是同一作者（TJ）后续更轻量的作品，Fastify / NestJS 是更新的高性能替代。本章从零起步搭建一个 Express 服务，理解它的核心约定。

一、Express 与同类框架对比

框架	风格	性能	生态	何时选
Express	中间件链式回调	一般	最大	老项目 / 通用
Koa2	async/await 中间件	略好	中等	现代项目
Fastify	插件式	最快	增长中	性能敏感
NestJS	装饰器 + DI	一般	大	企业级 / 团队

Express 不一定是"最好"的，但学习曲线最低、文档最全、第三方中间件最多——新项目入门首选。

二、安装与最小服务

mkdirmy-app&&cdmy-appnpminit-ynpminstallexpress

const express = require('express'); const app = express(); app.get('/', (req, res) => { res.send('Hello World'); }); app.listen(3000, () => { console.log('服务运行在 http://localhost:3000'); });

$nodeapp.js 服务运行在 http://localhost:3000

三、官方资源

资源	地址
英文官网	expressjs.com
中文官网	expressjs.com.cn
GitHub	expressjs/express

四、REST 风格路由

Express 推荐按 RESTful 风格设计路由——HTTP 方法 + URL 表达"对资源的操作"：

方法	路径	含义
`GET`	`/users`	用户列表
`GET`	`/users/:id`	单个用户详情
`POST`	`/users`	创建用户
`PUT`	`/users/:id`	整体更新用户
`PATCH`	`/users/:id`	部分更新用户
`DELETE`	`/users/:id`	删除用户

app.get('/users', listUsers); app.get('/users/:id', getUser); app.post('/users', createUser); app.put('/users/:id', updateUser); app.patch('/users/:id', partialUpdateUser); app.delete('/users/:id', deleteUser);

五、与原生 http 模块的关系

Express 是http模块的封装，底层完全一样：

每一段app.get(path, handler)内部：

注册到 Express 的路由表
http 服务收到请求后匹配 path
匹配到时调用 handler
handler 里通过res.send()/res.json()返回响应

Express 的价值不是性能，而是抽象掉 HTTP 协议解析——让你专注业务逻辑。

六、第一个完整服务

const express = require('express'); const app = express(); // JSON body 解析（Content-Type: application/json） app.use(express.json()); // 模拟数据库 const users = [ { id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }, ]; // 路由 app.get('/api/users', (req, res) => { res.json({ users }); }); app.get('/api/users/:id', (req, res) => { const user = users.find((u) => u.id === Number(req.params.id)); if (!user) { return res.status(404).json({ error: 'User not found' }); } res.json(user); }); app.post('/api/users', (req, res) => { const newUser = { id: users.length + 1, ...req.body }; users.push(newUser); res.status(201).json(newUser); }); app.listen(3000, () => { console.log('http://localhost:3000'); });

测试：

$curlhttp://localhost:3000/api/users{"users":[{"id":1,"name":"Alice"},{"id":2,"name":"Bob"}]}$curl-XPOST-H"Content-Type: application/json"\-d'{"name":"Carol"}'http://localhost:3000/api/users{"id":3,"name":"Carol"}

七、最佳实践

场景	推荐
项目起步	`npm init`+`npm install express`
路由设计	REST 风格（GET / POST / PUT / DELETE）
JSON 接口	`app.use(express.json())`解析请求体
文件上传	`multer`中间件
跨域	`cors`中间件（详见跨域 CORS）
路由拆分	`express.Router()`（详见路由）
自动重启	`nodemon`（见 nodemon 章节）