Unity 单例模式完全指南

大家好!我是 数擎 AI,一位热爱探索新技术的前端开发者,在这里分享前端和 Web3D、AI 技术的干货与实战经验。如果你对技术有热情,欢迎关注我的文章,我们一起成长、进步!
开发领域 :前端开发 | AI 应用 | Web3D | 元宇宙
技术栈 :JavaScript、React、ThreeJs、WebGL、Go
经验经验 :6 年+ 前端开发经验,专注于图形渲染和 AI 技术
开源项目 :AI 智简未来、晓智元宇宙、数字孪生引擎

一、什么是单例模式?

单例模式(Singleton Pattern) 是一种常用设计模式,核心思想是:

一个类只有一个实例,并提供一个全局访问点。

适用场景:

在游戏开发中,通常用于:

  • 🎵 AudioManager(音频管理)
  • 🎮 GameManager(游戏控制)
  • 🧠 DataManager(数据持久化)
  • 🖼 UIManager(界面逻辑)
  • 🗺 SceneManager(场景切换)

二、Unity 与单例的"冲突"

Unity 的 MonoBehaviour 无法用传统 C# 单例写法(new 关键字)创建实例:

限制 说明
不能使用 new MonoBehaviour 由 Unity 引擎托管
必须挂在 GameObject 上 无法脱离场景生命周期
多场景可能重复实例 场景加载可能重复创建组件实例

三、MonoBehaviour 单例实现方案

✅ 推荐写法(最通用)

csharp 复制代码
public class GameManager : MonoBehaviour
{
    public static GameManager Instance { get; private set; }

    private void Awake()
    {
        if (Instance != null && Instance != this)
        {
            Destroy(gameObject); // 防止重复实例
            return;
        }

        Instance = this;
        DontDestroyOnLoad(gameObject); // 场景切换不销毁
    }
}


### 使用方式:
```csharp
GameManager.Instance.DoSomething();

核心要点:

  • 使用 Awake() 初始化,确保运行时唯一
  • 使用 DontDestroyOnLoad 保持全局可访问性
  • 在有旧实例时销毁当前 GameObject(或反之)

四、泛型单例基类(进阶封装)

csharp 复制代码
public class Singleton<T> : MonoBehaviour where T : MonoBehaviour
{
    private static T _instance;
    private static readonly object _lock = new object();
    private static bool _applicationIsQuitting = false;

    public static T Instance
    {
        get
        {
            if (_applicationIsQuitting)
            {
                Debug.LogWarning("[Singleton] 已销毁,将不再创建实例:" + typeof(T));
                return null;
            }

            lock (_lock)
            {
                if (_instance == null)
                {
                    _instance = FindObjectOfType<T>();
                    if (_instance == null)
                    {
                        GameObject singletonObject = new GameObject(typeof(T).Name);
                        _instance = singletonObject.AddComponent<T>();
                        DontDestroyOnLoad(singletonObject);
                    }
                }
                return _instance;
            }
        }
    }

    protected virtual void OnDestroy()
    {
        _applicationIsQuitting = true;
    }
}

示例继承:

csharp 复制代码
public class AudioManager : Singleton<AudioManager>
{
    public void PlaySound(string clipName)
    {
        // 实现播放逻辑
    }
}

五、常见陷阱 ⚠️

陷阱 说明
❌ 多个场景创建多个实例 应用 DontDestroyOnLoad 并检测重复
❌ 在 OnDestroy 后再次访问 应避免退出时访问 Instance
❌ 静态实例未初始化 Unity 生命周期复杂,可能在未执行 Awake() 时访问 Instance

六、非 MonoBehaviour 单例(纯逻辑类)

适用于工具类、算法类等无需挂载到场景的:

csharp 复制代码
public class ConfigManager
{
    private static ConfigManager _instance;
    public static ConfigManager Instance => _instance ?? (_instance = new ConfigManager());

    private ConfigManager()
    {
        // 私有构造函数
    }
}

七、总结

类型 是否 MonoBehaviour 是否跨场景切换 是否自动创建
简单单例 ✅ 是 ✅ 是 ❌ 否(需手动挂载)
泛型单例 ✅ 是 ✅ 是 ✅ 是(自动创建)
纯逻辑单例 ❌ 否 ✅ 是 ✅ 是(自动创建)

✅ 建议:

  • 管理 UI、音频、数据等组件时使用 MonoBehaviour 单例;
  • 工具类使用普通 C# 单例;
  • 多场景中必须使用 DontDestroyOnLoad 配合检测重复。

八、附加建议与思考 💡

Service Locator 模式 有时比单例更灵活,适合大项目。

避免过度使用单例,否则可能造成依赖过强、测试困难。

Unity 2021+ 支持 ScriptableObject + Addressable 实现配置数据全局共享,也是替代方案之一。

结语

在 Unity 中掌握单例模式,不仅是对设计模式的理解,更是构建 可维护、可扩展、高内聚系统架构 的关键一步。

相关推荐
y = xⁿ16 分钟前
关于Agent工程落地
前端·人工智能·python
web打印社区31 分钟前
JS 静默打印怎么做:纯前端为什么不行,以及最小可跑通写法
开发语言·前端·javascript·websocket·网络协议·http·pdf
web打印社区37 分钟前
HTML5 静默打印:前端页面怎么调用打印机且尽量不弹窗
前端·javascript·vue.js·pdf·html·html5
Python大数据分析37 分钟前
开源免费、AI 驱动的 Web 打印设计器 OpenPrint:从拖拽设计到 ERP 对接全流程实战
前端·人工智能·开源
溪语流沙1 小时前
【每天一个CSS | Day11】赛博朋克故障风文字:红青分离 + 切片抖动
前端·css
liangshanbo12151 小时前
React Fiber:从“解决卡顿”到完整更新链路
前端·javascript·react.js
Timmy2 小时前
前端转全栈笔记:讲框架之前,先把 TypeScript 这关过了
前端·人工智能·node.js
计算机魔术师2 小时前
年收入650亿、亏420亿,Anthropic凭什么敢叫价万亿?
前端
Frag0ut2 小时前
Chrome Canary 最新实验功能:AI Mode、按设备筛选历史记录与 Gemini 自动改密
前端·人工智能·chrome·dev·beta·canary·最新实验功能
anew___2 小时前
《从零手写操作系统 (19):Ext2文件系统实战——从内存到磁盘的跨越》
java·服务器·前端·数据库·算法