Reflex 视频笔记(轻量 Unity DI 框架)¶

来源:YouTube 视频 Finally, a Unity Dependency Injection Framework That Just Works(@git-amend / Adam Myhre) 配套仓库:gustavopsantos/Reflex(MIT)

定位说明:Reflex 是一个轻量、高性能的开源 Unity DI 框架,作者 Gustavo Santos。它不是顶级商业插件(对比 Odin Inspector 那种级别的完整方案),也不是 Unity 官方收录的包。如果项目已经在用 Zenject / VContainer / Extenject / UniDi,不必为了它迁移;但如果想要一个"快、轻、AOT 友好"的最小可用方案,值得放进候选名单。

一句话总结¶

Reflex 是 Unity 上一款主打"快+轻+AOT 友好"的依赖注入容器。设计上对标 Zenject / VContainer,目标是在这两者已经很轻的基础上进一步缩减运行时代价,同时把 IL2CPP / WebGL 兼容性做成默认行为。

视频内容摘要¶

视频定位¶

• 频道:git-amend(Adam Myhre,Unity Insider / Certified Unity Professional Programmer)
• 主题:不是讲"什么是 DI",而是直接上手展示一个在 Unity 里能直接跑起来的 DI 框架(Reflex)。视频标题强调 "Finally... that just works",基调是"对比已有方案,这一个不容易踩坑"。
• 形式:实操演示 + 逐步说明。无前置理论铺垫。

视频章节(约 13 分钟)¶

视频传递的核心观点¶

1. 不要重复造 DI 轮子 — Unity 圈 DI 选择已经很多(Zenject / VContainer / Extenject / UniDi / USyrup),与其从头写,不如选一个维护活跃、社区成熟的方案。
2. Reflex 的卖点 — 在已有方案里属于"性能 + 体积"最激进的那一档;同时把 Unity 最容易翻车的两个点(AOT 编译、WebGL)作为一等公民处理。
3. 上手成本 — 视频演示下来,基础用法(ProjectScope + SceneScope + [Inject])与 VContainer 的 API 形态很接近,从 VContainer 迁过来几乎零学习成本。

开源仓库:gustavopsantos/Reflex¶

基本信息¶

性能定位(官方数据)¶

• 速度:Resolve 比 VContainer 快最多 414%,比 Zenject 快最多 800%
• GC 分配:比 VContainer 少最多 28%,比 Zenject 少最多 921%
• AOT 友好:基本没有运行时 Emit,在 IL2CPP / WebGL / iOS / 主机平台都能跑
• 不可变容器:线程安全、无锁、可预期

这些是仓库自述数据,选型时建议自己跑一次自己的业务场景的 benchmark 再下结论。

安装(三种方式)¶

方式 1:UPM(Git URL)
  https://github.com/gustavopsantos/reflex.git?path=/Assets/Reflex/#13.0.2

方式 2:OpenUPM
  openupm add com.gustavopsantos.reflex

方式 3:.unitypackage
  从 Releases 页面下载,直接拖进 Unity

核心 API 速览(与 README 同步)¶

using Reflex.Core;
using UnityEngine;

// 1) ProjectInstaller:在 ProjectScope 上注册全局绑定
public class ProjectInstaller : MonoBehaviour, IInstaller
{
    public void InstallBindings(ContainerBuilder builder)
    {
        builder.AddSingleton("Hello");
    }
}

// 2) SceneInstaller:在 SceneScope 上注册场景级绑定
public class GreetInstaller : MonoBehaviour, IInstaller
{
    public void InstallBindings(ContainerBuilder builder)
    {
        builder.AddSingleton("World");
    }
}

// 3) 注入到 MonoBehaviour
using Reflex.Attributes;
public class Greeter : MonoBehaviour
{
    [Inject] private readonly IEnumerable<string> _strings;

    private void Start()
    {
        Debug.Log(string.Join(" ", _strings));  // "Hello World"
    }
}

关键概念(视频里用到的)¶

平台兼容性¶

• iOS / Android / Windows / Mac / Linux
• PS4 / PS5 / Xbox One / Xbox Series X|S
• WebGL(IL2CPP 验证)
• 没有运行时 Emit → 不会撞 AOT 编译坑

适用场景 / 不适用场景¶

与其他 Unity DI 方案的横向对比¶

选型时只列"项目方自己公开的指标",不带主观推荐。

我对这条信息的归档定位¶

这是我从 YouTube 视频里偶然看到的一个 DI 仓库,不是我现在主推或正在使用的方案,所以这里只是存档:

• 不打算现在就整合到 Aesir / 个人项目主线(我们已有自己的解耦思路)
• 不放进 Plugins 顶级分类(它不属于 Odin / Feel 那种重量级)
• 但作为"Unity DI 选型时的一个轻量备选"留在知识库,以后有需要能快速找到
• 等真的用上,再独立写一篇实战笔记,而不是这一篇"视频摘要"

参考链接¶

• 视频: Finally, a Unity Dependency Injection Framework That Just Works(YouTube)
• 视频作者频道: @git-amend(Adam Myhre)
• 仓库: gustavopsantos/Reflex(GitHub)
• OpenUPM 列表: com.gustavopsantos.reflex
• 同一作者的另一部相关视频: Build Your Own Dependency Injection in less than 15 Minutes | Unity C#(YouTube)(手写一个最小 DI 框架,理解原理用)
• 同作者讲的 SOLID 之 D: D in SOLID - I wish I learned the LAST letter FIRST(YouTube)