这套教程讲什么
这是一套从零开始搭建企业级后端项目的教程,基于真实项目的架构提炼而成,覆盖:
- 项目初始化与环境配置
- 分层架构设计(Router / Controller / Service / Model)
- 统一响应格式与错误处理
- 中间件体系
- 依赖注入
- 完整 CRUD 实战
- 分页、搜索、鉴权等常见场景
- 数据库接入方式
适合谁看
- 有 JavaScript 基础,想学后端开发的前端工程师
- 想了解企业级 Node.js 项目怎么架构的开发者
- 想从 0 到 1 搭一个规范后端项目的人
技术栈
| 技术 | 版本 | 作用 |
|---|---|---|
| Node.js | >= 20 | 运行时 |
| TypeScript | 5+ | 类型安全 |
| Express | 5.x | Web 框架 |
| tsx | 4.x | TypeScript 运行/调试 |
怎么用这套教程
按顺序读,每一篇对应一个主题。每篇都有完整的代码示例,可以直接复制到项目里跑。
建议的学习顺序就是文件编号顺序:
| 编号 | 文件 | 主题 | 难度 |
|---|---|---|---|
| 01 | 01-项目概述与技术栈.md | 整体介绍、技术选型、目录结构 | ⭐ |
| 02 | 02-环境搭建与项目初始化.md | 从零搭项目、配置 TypeScript | ⭐ |
| 03 | 03-核心框架-App与中间件.md | Express App 创建、中间件执行顺序 | ⭐⭐ |
| 04 | 04-统一响应与错误处理.md | 响应格式、错误类、全局错误捕获 | ⭐⭐ |
| 05 | 05-分层架构设计思想.md | 为什么分层、每层职责是什么 | ⭐⭐ |
| 06 | 06-Model层-数据模型与操作.md | 数据模型定义、CRUD 基础方法 | ⭐⭐ |
| 07 | 07-Service层-业务逻辑.md | 业务规则、参数校验、多模型协调 | ⭐⭐⭐ |
| 08 | 08-Controller层-请求处理.md | 解析请求、调用 Service、返回响应 | ⭐⭐ |
| 09 | 09-Router层-路由配置.md | URL 映射、路由组织方式 | ⭐⭐ |
| 10 | 10-依赖注入与启动流程.md | 依赖注入、bootstrap、启动全过程 | ⭐⭐⭐ |
| 11 | 11-完整CRUD示例.md | 从零到一写完一个模块 | ⭐⭐⭐ |
| 12 | 12-分页与搜索.md | 分页参数、模糊查询、排序 | ⭐⭐ |
| 13 | 13-中间件进阶.md | 鉴权中间件、日志中间件、限流 | ⭐⭐⭐ |
| 14 | 14-数据库接入指南.md | 从内存存储切换到真实数据库 | ⭐⭐⭐⭐ |
运行示例代码
所有示例都可以在一个空项目里直接运行。只需要:
# 1. 按 02 号教程初始化项目
# 2. 按编号顺序把各篇的代码放进对应文件
# 3. 启动
npm run dev