VContainer-scoping/lifetime-overview | 作用域——生命周期管理总览

合集 - VContainer 中文文档(33)

1.VContainer 介绍02-172.VContainer-about/what-is-vcontainer | 概述——VContainer 是什么？02-173.VContainer-about/what-is-di | 概述——DI 是什么？02-174.VContainer-getting-started/installation | 入门——安装02-175.VContainer-getting-started/hello-world | 入门——Hello World02-176.VContainer-resolving/constructor-injection | 解析——构造函数注入02-177.VContainer-resolving/method-injection | 解析——方法注入02-178.VContainer-resolving/property-field-injection | 解析——属性/字段注入02-179.VContainer-resolving/gameobject-injection | 解析——注入到 MonoBehaviours 中02-1710.VContainer-resolving/container-api | 解析——容器 API02-1711.VContainer-registering/register-type | 注册——注册纯 C# 类型02-1712.VContainer-registering/register-using-delegate | 注册——注册使用委托02-1713.VContainer-registering/register-factory | 注册——注册工厂02-1714.VContainer-registering/register-monobehaviour | 注册——注册 MonoBehaviour02-1715.VContainer-registering/register-scriptable-object | 注册——注册 ScriptableObject02-1716.VContainer-registering/register-collection | 注册——注册集合02-1717.VContainer-registering/register-callbacks | 注册——注册回调02-1718.VContainer-integrations/entrypoint | 集成——纯 C# 入口点02-1719.VContainer-integrations/unitask | 集成——Unitask02-1820.VContainer-integrations/unirx | 集成——UniRx02-1821.VContainer-integrations/messagepipe | 集成——MessagePipe02-1822.VContainer-integrations/ecs | 集成——ECS (beta)02-18

23.VContainer-scoping/lifetime-overview | 作用域——生命周期管理总览02-18

24.VContainer-scoping/generate-child-via-scene | 作用域——通过场景或 prefab 生成子作用域02-1825.VContainer-scoping/generate-child-with-code-first | 作用域——通过代码优先生成子作用域02-1826.VContainer-scoping/project-root-lifetimescope | 作用域——项目根作用域 LifetimeScope02-1827.VContainer-diagnostics/diagnostics-window | 诊断——VContainer 诊断窗口02-1828.VContainer-optimization/source-generator | 优化——源码生成器02-1829.**VContainer-optimization/async-container-build | 优化——异步容器构建02-1830.VContainer-optimization/parallel-container-build | 优化——并行容器构建02-1831.VContainer-optimization/codegen | 优化——预生成 IL 代码（已弃用）02-1832.VContainer-comparing/comparing-to-zenject | 对比 Zenject02-1833.MessagePipe 中文文档02-20

收起

• Singleton（单例）: 全容器共享唯一实例。
  • 同容器内不可重复注册同一类型。
• Transient（瞬时）: 每次解析时创建新实例。
• Scoped（作用域内）: 每个 LifetimeScope 保持独立实例。
  • 如果 LifetimeScope 是唯一的，则类似于 Singleton。
  • 如果创建了子 LifetimeScope，每个子作用域将有不同的实例。
  • 当 LifetimeScope 被销毁时，会释放资源并调用所有注册的 IDisposable。

父子关系的生命周期

LifetimeScope 可以构建父子关系。
表现如下：

• 如果未找到注册的对象，LifetimeScope 会查找父级 LifetimeScope。
• 对于 Lifetime.Singleton
  • 基本上始终返回相同实例。
  • 父作用域和子作用域有相同的类型时，优先返回最近的作用域实例。
  • 当 LifetimeScope 被销毁时，实现了 IDisposable 的对象会调用 Dispose()。
• 对于 LifeTime.Transient
  • 每次解析都生成新实例。
  • 父作用域和子作用域存在同类型注册时，子作用域会创建自己的实例。
• 对于 Lifetime.Scoped
  • 每个子作用域保持独立实例。
    • 同一子作用域内实例相同。
  • 父作用域和子作用域存在同类型注册时，子作用域会创建自己的实例。
  • 当 LifetimeScope 被销毁时，实现了 IDisposable 的对象会调用 Dispose()。

:::caution
如果场景仍然存在，而 LifetimeScope 被销毁，注册为 Lifetime.Scoped 的 MonoBehaviours 不会自动销毁。
如果想在 LifetimeScope 销毁时一起销毁，可以将这类对象设置为 LifetimeScope 的子对象，或主动实现 IDisposable。
:::