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

这个 TypeScript 冷门功能，可无缝清理你的架构

news 2026/5/31 22:14:18

我有一支技术全面、经验丰富的小型团队，专注高效交付中等规模外包项目，有需要外包项目的可以联系我

上周我刷到一场挺精彩的讨论，主题是软件工程里最容易让人又爱又恨的模式之一——依赖注入（Dependency Injection）。

应用一旦长大，服务、控制器、工具类就会越堆越多。最烦的不是写业务，而是把它们一根根线接起来：哪里 new、哪里传参、哪里又多了一层转发……你以为自己在写系统，实际上你在当电工。

今天分享一个 TypeScript 里很“低调”的特性：它能让这些“接线”变得轻松很多，而且不需要 NestJS、Angular 这种重量框架。

我最近也用它给自己的类加了点“自动注入”的能力。我们会一起看它怎么运作、能用在哪些场景、以及它对类型安全到底意味着什么。

来，进入好玩的部分。

如何开始

这一步非常关键：你需要在tsconfig里打开两个设置：

// tsconfig.json { "compilerOptions": { "experimentalDecorators": true, "emitDecoratorMetadata": true } }

它们会为你的 TypeScript 项目启用装饰器支持（以及相关的元数据能力）。没有这一步，后面的“魔法”不会发生。

不用框架，也能把服务注入起来

接下来我们看一个模式：在不引入大型框架的前提下，让类与类之间自动连接。

属性装饰器（Property Decorator）是 TypeScript 规范的一部分。你只要在属性上标注@Inject，代码就会去一个“中央容器”里取依赖。类依然能拿到服务，只不过“接线”这件事在后台悄悄完成了。

下面这段代码就是一个最小可用的演示（原结构保留）：

const serviceContainer = new Map<string, any>(); function Injectable(serviceIdentifier: string) { return function (target: any) { serviceContainer.set(serviceIdentifier, new target()); } } function Inject(serviceIdentifier: string) { return function (target: any, propertyKey: string) { Object.defineProperty(target, propertyKey, { get: () => serviceContainer.get(serviceIdentifier), enumerable: true, configurable: true }); } } @Injectable('LoggerService') class LoggerService { log(message: string) { console.log(`[LOG]: ${message}`); } } class ProductService { @Inject('LoggerService') private logger!: LoggerService; createProduct(name: string) { this.logger.log(`Creating new product: ${name}`); } } const product = new ProductService() product.createProduct("Amit Book")

它在幕后到底做了什么？

核心机制其实不玄学，关键在这两点：

@Injectable('LoggerService')会把LoggerService的实例塞进全局容器（这里是一个Map）
@Inject('LoggerService')会在目标属性上挂一个 getter：当你访问this.logger时，它就去容器里把对应实例取出来

注意一个很容易被忽略的点：注入发生在类“被定义”的时候，而不是实例化的时候。

也就是说，只要类加载完成、装饰器执行过，这些映射关系就已经建立好了。

最终效果是什么？你不再需要写那种经典的构造函数接力：

没有constructor(db, logger, mailer...)的参数列车
没有层层工厂函数
也不需要把 logger 从祖宗组件一路传到曾孙组件

你只管声明“我需要什么”，剩下的让容器和 getter 默默处理。

我为什么会一眼爱上这种注入方式

说人话：它把我从“传参地狱”里拽出来了。

依赖不再层层传递：以前我为了让子模块拿到 logger，得穿过五层父级；现在一行@Inject就完事，零 prop drilling，零父子绑架
架构更顺：不用在一堆index.ts里集中 export 全家桶，也更少碰到那种绕晕人的循环依赖；你定义服务、注册服务、注入服务——装配就发生在容器该发生的位置
重构更轻松：当你只“索要接口/标识符”而不是到处new实现类时，替换实现的成本会低很多；你不用全工程搜new Class()改到手酸