Awilix TypeScript 依赖注入容器：完整指南

Awilix 是一个功能强大且灵活的依赖注入（DI）容器，专为 Node.js 和浏览器环境设计，使用 TypeScript 编写。它提供了一种优雅的方式来管理应用程序中的依赖关系，使代码更加模块化、易于测试和维护。本文将详细介绍如何在 TypeScript 项目中使用 Awilix，从安装到高级技巧。

1. 什么是 Awilix 以及为什么需要它

在现代软件开发中，控制反转（IoC）和依赖注入（DI）已成为构建可扩展、可测试应用程序的事实标准。Awilix 是一个 DI 容器的实现，负责创建和管理对象（服务、仓库、控制器等）的生命周期。您无需手动在其他类中创建类的实例（这会导致高度耦合），而是将依赖项注册到容器中，容器会自动将它们“注入”到需要的地方。

为什么需要它？首先，它极大地简化了测试。您可以在单元测试期间轻松地将真实实现（例如数据库）替换为模拟对象，只需在容器中注册不同的依赖项即可。其次，它改进了应用程序架构，迫使您遵循单一职责原则（SRP）并明确声明依赖项。第三，Awilix 支持多种对象生命周期（单例、瞬态、作用域），使您能够灵活地管理内存和状态。

Awilix 特别适合 TypeScript，因为它具有严格的类型检查。它提供了用于注册和解析依赖项的内置类型，允许在编译时捕获错误，而不是在运行时。该库支持异步依赖项解析、类、工厂函数和现有对象实例。

2. 安装

要在 TypeScript 项目中安装 Awilix，请在终端中执行以下命令：

npm install awilix

Awilix 内置了对 TypeScript 的支持，因此您无需安装单独的类型包（@types/awilix）。所有类型都已包含在主库中。

3. 快速入门——最小工作示例

让我们创建一个简单的应用程序，向用户问好。我们将有一个 Greeter 类，它依赖于 Logger。

import { createContainer, asClass, Lifetime } from 'awilix';

// 1. 定义依赖项
class Logger {
  log(message: string): void {
    console.log(`[LOG]: ${message}`);
  }
}

class Greeter {
  private logger: Logger;

  // 依赖项将通过构造函数注入
  constructor({ logger }: { logger: Logger }) {
    this.logger = logger;
  }

  greet(name: string): void {
    this.logger.log(`Hello, ${name}!`);
  }
}

// 2. 创建容器
const container = createContainer();

// 3. 注册依赖项
container.register({
  logger: asClass(Logger, { lifetime: Lifetime.SINGLETON }),
  greeter: asClass(Greeter, { lifetime: Lifetime.TRANSIENT }),
});

// 4. 解析（获取）Greeter 实例
const greeter = container.resolve<Greeter>('greeter');

// 5. 使用
greeter.greet('World'); // 输出: [LOG]: Hello, World!

在此示例中，我们创建了一个容器，注册了两个类（Logger 作为单例，Greeter 作为瞬态对象），然后解析了 Greeter。Awilix 自动创建了 Logger 实例并将其传递给 Greeter 的构造函数。

4. 主要方法/函数/类

让我们看看 Awilix 的关键 API。对于每个方法，都提供了签名、描述和示例。

4.1. createContainer()

签名：