如何实现一个轻量级的前端依赖注入（DI）容器？-js教程-PHP中文网

如何实现一个轻量级的前端依赖注入（DI）容器？

夜晨

发布： 2025-10-02 19:01:02

原创

184人浏览过

一个轻量级前端DI容器通过注册-解析机制实现依赖解耦，支持构造函数自动注入与单例管理，适用于插件系统、测试mock等场景，核心代码不足百行，提升可维护性与测试性。

如何实现一个轻量级的前端依赖注入（di）容器？

前端依赖注入（DI）容器的核心目标是解耦组件与依赖的创建过程，提升可测试性和可维护性。实现一个轻量级的 DI 容器并不需要复杂的设计模式或大量代码，关键在于理解“注册-解析”机制。

定义容器的基本结构

一个最简 DI 容器应支持：

注册依赖：将服务标识（token）与构造函数或工厂函数绑定
解析依赖：根据标识获取实例，自动处理依赖关系
生命周期管理：支持单例和瞬时模式

下面是一个基础实现：

class Container {
  constructor() {
    this.registry = new Map();
    this.instances = new Map(); // 缓存单例
  }

  register(token, provider, { singleton = true } = {}) {
    this.registry.set(token, { provider, singleton });
  }

  resolve(token) {
    if (this.instances.has(token)) {
      return this.instances.get(token);
    }

    const record = this.registry.get(token);
    if (!record) throw new Error(`No provider registered for ${String(token)}`);

    const instance = typeof record.provider === 'function'
      ? new record.provider(this)
      : record.provider;

    if (record.singleton) {
      this.instances.set(token, instance);
    }

    return instance;
  }
}

登录后复制

利用构造函数参数自动注入

通过 Function.prototype.toString() 解析构造函数参数，实现自动依赖查找。这是轻量级框架常见的手段。

立即学习“前端免费学习笔记（深入）”；

示例：为类添加元数据标记

function inject(...dependencies) {
  return function(target) {
    target.inject = dependencies;
  };
}

// 使用装饰器语法模拟
@inject('userService', 'logger')
class UserController {
  constructor(userService, logger) {
    this.userService = userService;
    this.logger = logger;
  }
}

登录后复制

在容器中解析带注入元数据的类：

轻幕

轻幕是一个综合性短视频制作平台，诗词、故事、小说等一键成片转视频，让内容传播更生动！

查看详情

resolve(token) {
  if (this.instances.has(token)) {
    return this.instances.get(token);
  }

  const record = this.registry.get(token);
  if (!record) throw new Error(...);

  let instance;
  if (typeof record.provider === 'function' && record.provider.inject) {
    const deps = record.provider.inject.map(dep => this.resolve(dep));
    instance = new record.provider(...deps);
  } else if (typeof record.provider === 'function') {
    instance = new record.provider(this);
  } else {
    instance = record.provider;
  }

  if (record.singleton) {
    this.instances.set(token, instance);
  }

  return instance;
}

登录后复制

简化使用方式

避免手动注册所有服务，可通过扫描或约定式注册减少配置。

例如，提供快捷注册方法：

bindClass(token, clazz, options) {
  this.register(token, clazz, options);
}

// 使用
container.bindClass('logger', ConsoleLogger);
container.bindClass('userService', UserService, { singleton: true });
container.bindClass('userController', UserController);

登录后复制

也可以支持异步依赖加载（如动态 import），适用于模块懒加载场景。