我有一支技术全面、经验丰富的小型团队,专注高效交付中等规模外包项目,有需要外包项目的可以联系我
上周我刷到一场挺精彩的讨论,主题是软件工程里最容易让人又爱又恨的模式之一——依赖注入(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()改到手酸
但类型安全会不会翻车?
这也是它最容易被吐槽的地方:注入是动态的。
编译器有时并不知道容器里到底有没有这个服务。 你写了@Inject('Logger'),但你可能忘了注册它——这件事不会在编译期拦住你,可能会在运行时用“空指针/undefined”教你做人。
有的人说这很危险。 我觉得它很灵活——但确实,灵活如果没有纪律,就会变成风险。
主要坑点一般在这里:
类型可能变得模糊:如果没开严格模式、或者容器类型太随意,被注入的属性很容易滑向
any控制力有限:构造注入缺参通常能早一点暴露(至少 IDE/类型系统更容易提示);属性装饰器这种方式更偏运行期失败,很多时候 IDE 不会主动提醒,除非你用更严格的约束/工具
最后的结论
装饰器注入不是要取代企业级框架。它不会白送你模块隔离、懒加载、复杂生命周期管理这些“豪华套餐”。
但它非常适合:
小中型项目想要 DI 的结构感
工具库/脚手架想减少样板代码
你明确知道自己在做什么,并愿意遵守容器注册规则
如果你要用注入,就别偷懒:
服务该注册就注册
别把容器当黑盒魔法
尊重类型系统,别让它为了“方便”而被你掏空
你把它当成一把精密刀,它就能干净利落; 你把它当成万能锤,它迟早会砸到自己的脚。
期待在评论区看到你的想法和建议。
谢谢,我们下次再聊一个架构小彩蛋。
全栈AI·探索:涵盖动效、React Hooks、Vue 技巧、LLM 应用、Python 脚本等专栏,案例驱动实战学习,点击二维码了解更多详情。
最后:
CSS终极指南
Vue 设计模式实战指南
20个前端开发者必备的响应式布局
深入React:从基础到最佳实践完整攻略
python 技巧精讲
React Hook 深入浅出
CSS技巧与案例详解
vue2与vue3技巧合集