装饰器是用于类或属性的元数据标记,帮助DI框架识别依赖关系。通过@Injectable()等装饰器标注可注入类,结合emitDecoratorMetadata反射机制,容器自动解析构造函数参数并递归实例化依赖,实现自动装配。NestJS等框架利用此特性完成模块化与解耦,需开启experimentalDecorators和emitDecoratorMetadata支持。

JavaScript 的装饰器在自动依赖注入(DI)框架中主要用于声明类或属性的元数据,从而让框架知道如何自动解析和注入依赖。虽然 JavaScript 本身的装饰器目前仍处于提案阶段(Stage 3),但在 TypeScript 中已广泛支持,因此很多现代框架如 NestJS 就基于此特性实现了强大的依赖注入机制。
什么是装饰器?
装饰器是一种特殊类型的声明,可以被附加到类、方法、访问器、属性或参数上,用于修改或增强其行为。它本质上是一个函数,在运行时被调用,并传入目标对象及其元信息。
例如:
@injectable()class Logger { }
@controller('/users')
class UserController {
@get('/')
findAll() { }
}
上面代码中的 @injectable() 和 @controller() 都是装饰器,它们为类添加了元数据,告诉 DI 容器这些类可以被管理。
立即学习“Java免费学习笔记(深入)”;
装饰器如何支持自动依赖注入?
在依赖注入框架中,装饰器的主要作用是标记可注入的类以及需要注入的位置,结合反射机制实现自动化装配。
- 标记可注入类:使用如 @Injectable() 装饰器标注服务类,表示该类可由容器创建和管理。
- 标识依赖关系:构造函数参数可通过 @Inject(Token) 明确指定所需依赖的令牌(Token),避免类型丢失问题。
- 自动解析依赖:容器读取类的构造函数参数类型(借助 TypeScript 的 emitDecoratorMetadata 特性),然后递归查找并实例化所有依赖项。
示例:
@Injectable()class DatabaseService { }
@Injectable()
class UserService {
constructor(private db: DatabaseService) { }
}
// 容器能通过反射得知 UserService 需要 DatabaseService 实例
实际应用场景(以 NestJS 为例)
NestJS 是一个典型的使用装饰器 + 依赖注入的 Node.js 框架。
- 使用 @Module() 装饰器定义模块,并列出提供者(providers)、控制器(controllers)等。
- 使用 @Injectable() 标记服务,使其可被注入到其他组件中。
- 控制器通过构造函数接收服务实例,框架自动完成注入。
这种设计使得代码高度解耦,便于测试与维护。
需要注意的问题
要使装饰器配合依赖注入正常工作,需注意以下几点:
- TypeScript 配置中必须开启 experimentalDecorators 和 emitDecoratorMetadata。
- 依赖的类型信息在编译后可能丢失,建议配合 Injection Token 使用以提高可靠性。
- 装饰器不能直接用于普通函数或变量,只能用于类及其成员。
基本上就这些。装饰器本身不执行注入,而是提供“线索”,真正的注入逻辑由框架的容器完成。这种方式让依赖管理变得声明式且透明。










