种设计模式 + DI：Nest.js 后端第一课

前面十几节课，我基本都在写前端：组件、路由、Canvas、ESLint、Next.js 全栈。老实说，代码越写越多，但每次和后端打交道还是发虚——接口怎么组织？业务逻辑放哪一层，为什么后端框架一上来就满屏 @ 装饰器？

这节课第一次正式往后端走一步。工具是 Nest.js，

笔记翻完一遍，我发现这节课表面是「学一个后端框架」。实际是用 Nest.js 当样本，把三种设计模式和依赖注入一次讲清楚——工厂模式、MVC、装饰器、DI，外加一个 Restful 思想。Nest.js 只是这些思想的载体。

使用者痛点回顾

• 接口组织不清晰不知道应该把路由、业务逻辑和数据访问分别放在哪。
• 业务逻辑混乱控制器里写了太多业务，导致难以维护与测试。
• 装饰器符号过多，语义模糊看到大量 @Module @Controller @Injectable @Get 等等 时不知它们到底代表什么。按理说，
• 手动实例化导致耦合过高每个 Controller 都直接 new 一个 Service。换实现时需要改代码，
• Error handling 不完善未使用统一异常类，导致错误响应不一致。
• No clear separation of concerns

：先把定位说清楚

Nest.js 的定位是：

为什么选择 Nest.js？

• 提供 API 接口，做 Web 开发；程序集成并发底层服务，微服务架构支持。
• Nest 用约定解决代码分层、模块边界、依赖管理与团队协作问题，让你在代码越来越多时仍能保持结构清晰。

二、安装与第一个项目

# 全局安装 CLI 并创建项目:

npm i -g @nestjs/cli
nest new hello
nest start

Nest 自动生成 /src/main.ts 与 /src/app.module.ts。说起来，CLI 提供常用脚本如 build/start/dev/debug/prod/lint/test 等。至于主要依赖包括，

• : 主要装饰器与工具。
• : 运行时主要，如 NestFactory.
• : 把 Nest 与 Express 结合的适配层。
• : 装饰器元数据存取库。
• : 响应式编程库，用于异步流程处理。

Tip: 记得在 tsconfig.json 中开启 “experimentalDecorators” 与 “emitDecoratorMetadata”。

三、Nest.js 的设计模式基因拆解—工厂模式

为什么要工厂?说起来，

*痛点*: 每次需要创建不同类型的应用时都得手动 new。一旦变化就需要改大量代码。*

工厂模式: 将对象创建封装到工厂中。让调用方只关心“需要什么”，而不管“怎么创建”。从**主要**来看，返回同一种抽象类型，内部可替换具体实现。

• Simplified Factory – 选型；Sub-Factories – 子类化 Abstract Factory – 一族产品产出。 &nsp

NestFactory 实例演示:

const app = await NestFactory.create;await app.listen;

• Avoids tight coupling 娱乐ween AppModule and underlying server implementation.

- 通过传入 AppModule 创建完整应用；- 返回的是抽象 App 对象，内部可能使用 Express 或 Fastify；- 调整底层实现。只需改 factory 配置即可，无需改业务代码。

常见误区 & 方法

• 至于*错误*。手动 `new` 每个子模块导致内存泄漏 & 单例失效 再看*正确*，`@Injectable` + IOC 容器管理单例生命周期。从*错误*来看，直接暴露实现细节给外部调用者 *正确*这方面。保持对抽象接口的依赖，在工厂内部完成所有实例化细节。不过，

  深入阅读 →。JavaScript Meta‑programming — Decorators]

  ---

  四 MVC / 分层

  痛点: 没有分层导致一个文件千行难以维护。话说回来，

  text 视图 层 └── 控制器 层 └── 服务层 └── 仓储 / Repository 层 xx.module.ts | xx.controller.ts | xx.service.ts

  主要

  1. Controller – 路由入口 + 参数校验 + 简单逻辑；话说回来，
  2. Service – 真正业务逻辑 + 调用仓储；
  3. Repository – 数据访问。其实，

  五 装饰器

  痛点: 大量 @ 符号让人迷惑。

  装饰器	用途
  @Module	声明模块及其依赖
  @Controller	声明控制器及路由前缀
  @Injectable	注册可被注入的服务
  @Get / @Post / ...	标记 HTTP 方法

  ts @Module({ imports:。controllers:,providers:,}) export class AppModule {}

  六 依赖注入

  痛点: 手动 new 导致耦合紧且难以测试。

  ts // 正确方式： constructor {}

  幕后原理

  1. 编译阶段 @Injectable 注解被保存在元数据中；
  2. IOC 容器扫描并实例化所有 Provider；
  3. 在创建 Controller 时自动注入相同类型实例。

  七 RESTful CRUD 示例

  路由映射

  HTTP 方法	方法	装饰器	参数来源	Service 方法
  GET	/todos	@Get	N/A	findAll
  GET	/todos/:id	@Get| @Param| findOne
  POST	/todos	@Post	@Body| create
  PATCH	/todos/:id	@Patch| 两者	_update
  DELETE	/todos/:id	@Delete|	remove

  Service 主要实现

  ts @Injectable export class TodosService { private todos: Todo =;

  findAll: Todo { return this.todos;} findOne: Todo { const todo = this.todos.find;其实，if throw new NotFoundException;return todo，} create的观点是，Todo { /.../ } }

  八 异常处理

  ts if throw new NotFoundException;

  效果

  json { "statusCode":404,"message":"Todo XXX not found" }

  九  &️‍♂️ 如何避免重复错误？

  1️⃣ 工厂模式 → 解耦应用创建 2️⃣ MVC 分层 → 清晰职责划分 3️⃣ 装饰器 → 声明式配置 4️⃣ DI → 对象生命周期管理 5️⃣ RESTful → 明确接口语义

  将上述五件事组合成一条主线，你就能从“看不见的接口”和“无序的业务”走向“可维护、高效协作”的后端工程师状态。

  ---

  常见术语速查

  #术语名称 #说明 #示例 #备注 #链接 #类别 #是否必学 #难易度 #推荐学习顺序 #学习资源数目
  #END#TermList#END# TermList End!怎么说呢，
  #END#TermTable#END# TermTable End!
  #END#TermInfoTable#END# TermInfoTable End!不过，

  ---

  附录 — 快速开始脚本

  bash npm i -g @nestjs/cli && \ nest new my-app && \ cd my-app && \ nest start --watch &

  💡 想要更快地掌握 NestJS。请先熟悉 TypeScript 基础与 NodeJS 异步模型，接下来再逐步拆解上述五大关键概念。祝编码愉快，