基于 TypeScript + Express 5 + 分层架构的实战教程 — 导读

0 阅读2分钟

这套教程讲什么

这是一套从零开始搭建企业级后端项目的教程,基于真实项目的架构提炼而成,覆盖:

  • 项目初始化与环境配置
  • 分层架构设计(Router / Controller / Service / Model)
  • 统一响应格式与错误处理
  • 中间件体系
  • 依赖注入
  • 完整 CRUD 实战
  • 分页、搜索、鉴权等常见场景
  • 数据库接入方式

适合谁看

  • 有 JavaScript 基础,想学后端开发的前端工程师
  • 想了解企业级 Node.js 项目怎么架构的开发者
  • 想从 0 到 1 搭一个规范后端项目的人

技术栈

技术版本作用
Node.js>= 20运行时
TypeScript5+类型安全
Express5.xWeb 框架
tsx4.xTypeScript 运行/调试

怎么用这套教程

按顺序读,每一篇对应一个主题。每篇都有完整的代码示例,可以直接复制到项目里跑。

建议的学习顺序就是文件编号顺序:

编号文件主题难度
0101-项目概述与技术栈.md整体介绍、技术选型、目录结构
0202-环境搭建与项目初始化.md从零搭项目、配置 TypeScript
0303-核心框架-App与中间件.mdExpress App 创建、中间件执行顺序⭐⭐
0404-统一响应与错误处理.md响应格式、错误类、全局错误捕获⭐⭐
0505-分层架构设计思想.md为什么分层、每层职责是什么⭐⭐
0606-Model层-数据模型与操作.md数据模型定义、CRUD 基础方法⭐⭐
0707-Service层-业务逻辑.md业务规则、参数校验、多模型协调⭐⭐⭐
0808-Controller层-请求处理.md解析请求、调用 Service、返回响应⭐⭐
0909-Router层-路由配置.mdURL 映射、路由组织方式⭐⭐
1010-依赖注入与启动流程.md依赖注入、bootstrap、启动全过程⭐⭐⭐
1111-完整CRUD示例.md从零到一写完一个模块⭐⭐⭐
1212-分页与搜索.md分页参数、模糊查询、排序⭐⭐
1313-中间件进阶.md鉴权中间件、日志中间件、限流⭐⭐⭐
1414-数据库接入指南.md从内存存储切换到真实数据库⭐⭐⭐⭐

运行示例代码

所有示例都可以在一个空项目里直接运行。只需要:

# 1. 按 02 号教程初始化项目
# 2. 按编号顺序把各篇的代码放进对应文件
# 3. 启动
npm run dev