不良实践

每次调用 register* 后，请继续使用该方法返回的容器引用。旧引用仍携带旧的依赖图类型，即使它指向同一个运行时容器。

复用旧引用

每个 register* 方法都会修改容器，并返回带有扩展泛型类型的同一对象。TypeScript 会扩展返回值的类型，但不会更改调用前创建的引用类型。

class Consumer {
  constructor(readonly dependency: number) {}
}

const base = new Container()
const syncGraph = base
  .registerValue('dependency', 1)
  .registerClass('consumer', Consumer, ['dependency'])

// 这段代码可以编译，因为 base 的类型仍是 Container<{}>。
base.registerAsyncFactory('dependency', async () => 2, [])

// TypeScript 认为这里是 number，但新注册会提供 Promise<number>。
syncGraph.get('consumer').dependency

base 和 syncGraph 指向同一个对象。最后一次调用会覆盖 dependency 的运行时注册，而 syncGraph 的类型仍描述原来的同步依赖图。覆盖前注册的类也会保留原来的依赖分类。

编译器为何允许这段代码

重复键检查读取当前引用的依赖图类型。syncGraph 的类型包含 dependency，因此通过 syncGraph 再次注册该键会产生类型错误。base 的类型仍是 Container<{}>，其中 keyof T 为 never。

TypeScript 不会更新一个可变对象所有别名的泛型参数。它也没有 linear type 或 affine type，无法在注册后把 base 标记为已使用。InferDI 不会在每次注册时查询 registry 来追踪旧引用，因为这种检查会增加正确依赖图的构建成本。

使用最新返回的引用

请用一条调用链构建依赖图，并使用最终结果：

const container = new Container()
  .registerValue('dependency', 1)
  .registerClass('consumer', Consumer, ['dependency'])

container.get('consumer')

不要忽略 register* 的返回值，也不要通过旧引用继续注册。模块也应返回最后一次注册产生的容器。参见模块。

不要把 register* 当作替换 API

构建生产依赖图时，每个键只选择一次实现。配置需要选择不同实现时，请使用普通条件分支或 .use()。

测试可以在解析依赖图之前调用 .override()，前提是替换值保留原有的生命周期、惰性模式和异步模式。.override() 不能把同步注册转换为声明式异步注册。参见测试与覆盖。