1. 项目概述为什么我们需要一个UI框架做Unity开发尤其是涉及到稍微复杂一点的游戏或者应用UI管理绝对是个绕不开的坎。新手阶段我们可能习惯性地在场景里拖拽一堆Canvas然后在每个按钮的Inspector面板里直接拖拽函数写一堆Find、GetComponent。项目小的时候这没什么问题甚至感觉挺方便。但一旦UI数量多起来逻辑复杂起来比如需要处理界面之间的跳转、数据更新、动画播放、多语言切换你就会发现代码已经乱成一锅粥维护起来苦不堪言。一个按钮的点击事件可能散落在五六个脚本里改个功能要全局搜索新增一个界面生怕影响到其他不相关的地方。这就是UI框架要解决的问题。它不是一个具体的插件而是一套管理UI生命周期、数据驱动、消息通信和代码组织的设计模式与工具集。简单说它帮你把UI的“显示逻辑”和“业务逻辑”分开让界面像搭积木一样清晰可控。这次我们不空谈理论直接动手从零搭建一个轻量、实用、可扩展的UI框架你会看到它如何将你从UI的泥潭中拯救出来让开发效率和质量提升一个档次。无论你是独立开发者还是团队协作掌握一套自己的UI框架都是迈向资深的关键一步。2. 核心设计思路与架构选型在动手写代码之前我们必须想清楚这个框架要解决哪些核心痛点以及我们选择何种架构来应对。盲目照搬别人的框架往往水土不服理解背后的设计思想才能灵活运用。2.1 我们需要框架解决什么问题首先明确我们的核心需求清单界面生命周期管理界面的加载、显示、隐藏、卸载需要有一套统一的流程避免内存泄漏和资源管理混乱。代码与资源解耦UI预制体Prefab的路径、UI逻辑脚本、UI数据模型应该分离。修改资源路径不应导致逻辑代码大范围改动。便捷的界面跳转与导航打开、关闭界面界面间的传参以及类似“返回上一级”这样的导航栈管理。数据驱动更新当游戏内的数据如玩家金币、血量发生变化时UI能自动更新而不是到处手动调用UpdateText。消息通信解耦界面与界面之间界面与游戏系统如背包系统、任务系统之间需要低耦合的通信方式避免直接相互引用。通用组件与工具如统一的弹窗管理器、加载等待界面、多语言、UI动画模板等避免重复造轮子。2.2 为何选择基于MVC变体的架构市面上常见的UI框架架构有MVCModel-View-Controller、MVPModel-View-Presenter、MVVMModel-View-ViewModel等。对于Unity游戏开发尤其是中小型项目一个经过简化的MVC变体往往是最实用、最容易上手的。Model模型代表UI要展示或交互的数据。例如一个角色属性界面它的Model就是包含生命值、攻击力等属性的数据类。它不关心UI如何显示。View视图就是我们在Unity中制作的UI预制体以及挂载在上面负责“显示”的脚本。它持有UI组件的引用如Text、Image、Button并暴露一些方法供Controller调用以更新显示。Controller控制器这是核心。它负责协调Model和View。它从游戏系统获取数据填充到Model然后命令View更新。它也接收来自View的输入事件如按钮点击并转化为具体的业务逻辑可能还会修改Model。为什么选它因为职责清晰符合Unity以GameObject为核心的开发习惯。View就是GameObjectController是MonoBehaviour脚本Model是纯C#类三者界限分明易于理解和调试。相比MVVM需要数据绑定框架在Unity中通常需要额外插件或较多反射简化MVC的实现成本更低对性能也更友好。注意这里我们谈的是“简化”或“变体”。经典的MVC中View和Model有时能直接通信但在游戏UI中我们通常严格禁止View和Model直接交互所有通信都通过Controller这更像MVP的模式。但名字不重要理解这种“数据-逻辑-显示”分离的思想才是关键。2.3 框架核心模块划分基于以上思路我们的框架将包含以下几个核心模块UIManagerUI管理器单例全局唯一。负责所有UI面板的加载、实例化、存储、显示/隐藏和销毁。是整个框架的总调度中心。BasePanel基类面板所有UI面板的Controller基类。定义生命周期方法如OnInit, OnShow, OnHide, OnClose并封装一些通用操作如查找组件、添加监听。UILayerUI层级定义UI的渲染层级如背景层、普通层、弹窗层、提示层、顶层。确保界面正确叠加避免视觉错误。UIEventSystem事件系统一个简易的消息/事件中心用于模块间解耦通信。界面A关闭时可以发送一个“背包已更新”的事件界面B监听该事件并刷新。ResourceManager资源管理器虽然Unity有Resources和Addressables但框架需要封装一层统一的资源加载接口让UIManager不关心具体的加载方式。3. 框架核心模块实现详解理论说再多不如一行代码。我们现在就进入实战环节一步步实现上述核心模块。我会先给出代码骨架然后解释关键设计点和注意事项。3.1 定义UI层级与类型首先我们需要用枚举定义好UI的层级这决定了Canvas的排序顺序。// UILayer.cs public enum UILayer { Background 0, // 背景层如全屏遮罩 Normal 100, // 普通界面层主界面、设置页等 PopUp 200, // 弹窗层警告框、确认框 Tips 300, // 提示层飘字提示、小图标 Top 400 // 顶层新手引导、系统菜单 }同时定义UI的类型决定其显示行为// UIPanelType.cs public enum UIPanelType { Normal, // 普通界面可同时打开多个如背包和角色面板 PopUp, // 弹窗通常需要背景遮罩并可能暂停下层界面交互 Fixed, // 固定界面常驻显示如血条、小地图 Exclusive // 独占界面打开时会关闭其他所有同层或下层界面如全屏剧情对话 }3.2 实现UI管理器UIManagerUIManager是单例使用懒汉式或饿汉式均可。这里为了线程安全虽然Unity主线程单线程但好习惯使用双重检查锁或静态初始化。// UIManager.cs using System.Collections.Generic; using UnityEngine; public class UIManager : MonoBehaviour { private static UIManager _instance; public static UIManager Instance { get { if (_instance null) { GameObject go new GameObject(UIManager); _instance go.AddComponentUIManager(); DontDestroyOnLoad(go); // 跨场景不销毁 _instance.Init(); } return _instance; } } // 根Canvas不同层级的Panel会挂载到对应的子节点下 private Transform _uiRoot; private DictionaryUILayer, Transform _layerRoots new DictionaryUILayer, Transform(); // 存储所有已打开的面板 [面板名字 面板实例] private Dictionarystring, BasePanel _panelDict new Dictionarystring, BasePanel(); private void Init() { // 创建UI根节点 CreateUIRoot(); } private void CreateUIRoot() { // 如果场景中已存在则直接使用 _uiRoot GameObject.Find(UIRoot)?.transform; if (_uiRoot null) { GameObject rootGo new GameObject(UIRoot); _uiRoot rootGo.transform; Canvas canvas rootGo.AddComponentCanvas(); canvas.renderMode RenderMode.ScreenSpaceOverlay; rootGo.AddComponentUnityEngine.UI.CanvasScaler(); rootGo.AddComponentUnityEngine.UI.GraphicRaycaster(); DontDestroyOnLoad(rootGo); } // 为每个层级创建子节点 foreach (UILayer layer in System.Enum.GetValues(typeof(UILayer))) { string layerName layer.ToString(); Transform layerTrans _uiRoot.Find(layerName); if (layerTrans null) { GameObject layerGo new GameObject(layerName); layerTrans layerGo.transform; layerTrans.SetParent(_uiRoot); layerTrans.localPosition Vector3.zero; layerTrans.localScale Vector3.one; // 为该层级添加Canvas和排序组件 Canvas layerCanvas layerGo.AddComponentCanvas(); layerCanvas.overrideSorting true; layerCanvas.sortingOrder (int)layer; // 使用枚举值作为排序order layerGo.AddComponentUnityEngine.UI.GraphicRaycaster(); } _layerRoots[layer] layerTrans; } } }这里的关键点是分层管理。我们为每个UILayer创建了一个独立的GameObject作为子节点并挂载了Canvas。每个Canvas的sortingOrder直接设置为枚举的整数值。这样做的好处是结构清晰在Hierarchy中一目了然。性能优化不同层级的UI元素位于不同的Canvas下当某一层级的UI发生变化时只会引起该Canvas的重绘而不是整个UI树。便于控制我们可以轻松地禁用某一层的所有交互如禁用背景层下的所有Raycaster。实操心得Canvas的overrideSorting属性必须打开否则子Canvas的sortingOrder不会生效。另外每个层级都加GraphicRaycaster是为了确保各层UI都能接收点击事件。如果你希望非顶层UI不接收事件可以在显示/隐藏面板时动态开关它。3.3 实现面板基类BasePanelBasePanel是所有具体UI面板控制器的基类。它采用泛型设计方便子类快速获取自身类型。// BasePanel.cs using UnityEngine; using UnityEngine.UI; public abstract class BasePanelT : MonoBehaviour where T : BasePanelT { // 面板名称通常与预制体名、资源路径相关 public string PanelName { get; protected set; } // 面板所属层级 public UILayer Layer { get; protected set; } UILayer.Normal; // 面板类型 public UIPanelType PanelType { get; protected set; } UIPanelType.Normal; // 面板的RectTransform缓存因为最常用 private RectTransform _rectTransform; public RectTransform RectTrans { get { if (_rectTransform null) _rectTransform GetComponentRectTransform(); return _rectTransform; } } /// summary /// 初始化面板由UIManager在实例化后调用 /// /summary public virtual void InitPanel(string panelName, UILayer layer, UIPanelType type) { PanelName panelName; Layer layer; PanelType type; // 将自己挂载到对应层级的节点下 Transform layerRoot UIManager.Instance.GetLayerRoot(layer); if (layerRoot ! null) { transform.SetParent(layerRoot, false); // 使用false保持本地坐标和缩放非常重要 RectTrans.anchoredPosition3D Vector3.zero; RectTrans.localScale Vector3.one; } } // 生命周期方法 public virtual void OnShow(object data null) { gameObject.SetActive(true); // 可以在这里处理传入的参数 data } public virtual void OnHide() { gameObject.SetActive(false); } public virtual void OnClose() { // 通常由UIManager调用执行销毁前的清理工作 Destroy(gameObject); } // 一些工具方法方便子类使用 protected TComponent FindComponentTComponent(string path) where TComponent : Component { Transform target transform.Find(path); if (target ! null) return target.GetComponentTComponent(); Debug.LogWarning($在面板{PanelName}中未找到路径{path}下的组件{typeof(TComponent).Name}); return null; } protected Button FindButton(string path, UnityEngine.Events.UnityAction onClick) { Button btn FindComponentButton(path); if (btn ! null onClick ! null) btn.onClick.AddListener(onClick); return btn; } // ... 可以继续封装FindText, FindImage等 }基类做了几件重要的事封装通用属性名称、层级、类型。规范生命周期InitPanel,OnShow,OnHide,OnClose为所有面板提供了统一的“入口”和“出口”。提供工具方法FindComponent和FindButton封装了繁琐的Transform.Find和GetComponent操作让子类代码更简洁。这里使用路径查找虽然性能不如直接引用但对于快速开发和原型阶段非常方便。后期可以优化为自动绑定或序列化引用。踩坑记录transform.SetParent(parent, false);这里的false参数至关重要。它表示保持子物体相对于世界坐标系的位置、旋转和缩放不变。如果设为trueUI的RectTransform的锚点、位置信息可能会被父节点重置导致UI显示错位。这是新手常犯的错误。3.4 完善UIManager的面板管理功能现在我们在UIManager中添加打开、关闭、查找面板的核心方法。// 在UIManager类中继续添加 public BasePanel ShowPanel(string panelName, UILayer layer UILayer.Normal, UIPanelType type UIPanelType.Normal, object data null) { // 1. 检查是否已打开 if (_panelDict.TryGetValue(panelName, out BasePanel panel)) { // 已存在直接显示 panel.OnShow(data); return panel; } // 2. 加载预制体这里先用Resources实际项目应替换为Addressables或AssetBundle string path $UI/Panels/{panelName}; // 假设预制体放在Resources/UI/Panels/下 GameObject panelPrefab Resources.LoadGameObject(path); if (panelPrefab null) { Debug.LogError($UI面板预制体加载失败: {path}); return null; } // 3. 实例化并初始化 GameObject panelGo Instantiate(panelPrefab); BasePanel newPanel panelGo.GetComponentBasePanel(); if (newPanel null) { Debug.LogError($预制体{panelName}上未找到BasePanel组件或其子类); Destroy(panelGo); return null; } newPanel.InitPanel(panelName, layer, type); _panelDict.Add(panelName, newPanel); // 4. 根据面板类型处理特殊逻辑如独占界面 HandlePanelTypeLogic(newPanel, type); // 5. 调用显示生命周期 newPanel.OnShow(data); return newPanel; } public void HidePanel(string panelName) { if (_panelDict.TryGetValue(panelName, out BasePanel panel)) { panel.OnHide(); } } public void ClosePanel(string panelName) { if (_panelDict.TryGetValue(panelName, out BasePanel panel)) { panel.OnClose(); _panelDict.Remove(panelName); // 根据面板类型可能需要恢复其他界面如关闭独占界面后 // ... } } public T GetPanelT(string panelName) where T : BasePanel { if (_panelDict.TryGetValue(panelName, out BasePanel panel)) { return panel as T; } return null; } private void HandlePanelTypeLogic(BasePanel panel, UIPanelType type) { switch (type) { case UIPanelType.Exclusive: // 隐藏所有同层及下层普通界面 foreach (var kvp in _panelDict) { if (kvp.Value ! panel kvp.Value.Layer panel.Layer kvp.Value.PanelType UIPanelType.Normal) { kvp.Value.OnHide(); } } break; case UIPanelType.PopUp: // 可以在这里为弹窗添加一个背景遮罩 // CreateBackgroundMask(panel.Layer); break; // ... 其他类型处理 } } // 提供给BasePanel获取层级根节点的方法 public Transform GetLayerRoot(UILayer layer) { _layerRoots.TryGetValue(layer, out Transform root); return root; }ShowPanel方法是核心它串联了从资源加载到界面显示的全流程。其中HandlePanelTypeLogic体现了框架的“智能”之处能根据面板类型自动处理一些界面关系比如打开一个独占界面时自动隐藏下层的普通界面这比手动管理要可靠得多。4. 实战创建一个完整的设置界面现在我们用自己搭建的框架来创建一个具体的UI面板——游戏设置界面。我们将完整经历从预制体制作、脚本编写到功能调用的全过程。4.1 创建UI预制体与挂载脚本创建预制体在Unity中创建一个新的UI Canvas如果UIRoot已存在则在其Normal层下创建。添加背景、标题、音量滑动条、画质下拉菜单、确认和取消按钮等元素。结构大致如下SettingsPanel (Canvas) ├── Background (Image) ├── Title (Text) ├── VolumeGroup (Panel) │ ├── Label (Text) │ └── Slider_Volume (Slider) ├── QualityGroup (Panel) │ ├── Label (Text) │ └── Dropdown_Quality (Dropdown) ├── Button_Confirm (Button) └── Button_Cancel (Button)制作完成后将其拖入Resources/UI/Panels/文件夹命名为SettingsPanel.prefab。创建面板控制器脚本// SettingsPanel.cs using UnityEngine; using UnityEngine.UI; public class SettingsPanel : BasePanelSettingsPanel { // UI组件引用 private Slider _volumeSlider; private Dropdown _qualityDropdown; private Button _confirmBtn; private Button _cancelBtn; // 数据模型这里简化实际可能是一个可序列化的配置类 private float _currentVolume; private int _currentQualityLevel; public override void InitPanel(string panelName, UILayer layer, UIPanelType type) { base.InitPanel(panelName, layer, type); // 初始化UI组件引用 _volumeSlider FindComponentSlider(VolumeGroup/Slider_Volume); _qualityDropdown FindComponentDropdown(QualityGroup/Dropdown_Quality); _confirmBtn FindButton(Button_Confirm, OnConfirmClick); _cancelBtn FindButton(Button_Cancel, OnCancelClick); // 初始化UI状态从PlayerPrefs或游戏管理器读取 _currentVolume PlayerPrefs.GetFloat(MasterVolume, 1.0f); _currentQualityLevel PlayerPrefs.GetInt(GraphicsQuality, QualitySettings.GetQualityLevel()); _volumeSlider.value _currentVolume; _qualityDropdown.ClearOptions(); _qualityDropdown.AddOptions(new System.Collections.Generic.Liststring(QualitySettings.names)); _qualityDropdown.value _currentQualityLevel; } public override void OnShow(object data null) { base.OnShow(); // 显示时可以播放一个渐入动画 // StartCoroutine(FadeIn()); } private void OnConfirmClick() { // 保存设置 _currentVolume _volumeSlider.value; _currentQualityLevel _qualityDropdown.value; PlayerPrefs.SetFloat(MasterVolume, _currentVolume); PlayerPrefs.SetInt(GraphicsQuality, _currentQualityLevel); PlayerPrefs.Save(); // 应用设置 AudioListener.volume _currentVolume; QualitySettings.SetQualityLevel(_currentQualityLevel); Debug.Log(设置已保存并应用); // 关闭面板 UIManager.Instance.ClosePanel(PanelName); } private void OnCancelClick() { // 不保存直接恢复原值如果之前有临时存储的话 // 这里简单直接关闭 UIManager.Instance.ClosePanel(PanelName); } }将这个脚本挂载到SettingsPanel预制体的根节点上。4.2 在游戏中调用现在在任何需要打开设置界面的地方比如主菜单的一个按钮点击事件你只需要一行代码// 在某个脚本中例如 MainMenuController.cs public void OnSettingsButtonClicked() { // 打开设置面板指定为弹窗层类型为弹窗 UIManager.Instance.ShowPanel(SettingsPanel, UILayer.PopUp, UIPanelType.PopUp); }你看调用变得极其简单。你不再需要关心预制体放在哪里、如何实例化、放在哪个Canvas下、如何管理它的显示隐藏。所有这些脏活累活都由UIManager和BasePanel替你完成了。这就是框架带来的效率提升。4.3 数据驱动更新的扩展上面的例子是UI主动拉取数据PlayerPrefs。更常见的场景是数据变化驱动UI更新。我们可以引入一个简易的事件系统或者使用观察者模式。这里我们实现一个超简易的消息中心作为示例// MessageCenter.cs (简易版) using System; using System.Collections.Generic; public class MessageCenter { private static Dictionarystring, Actionobject _eventDict new Dictionarystring, Actionobject(); public static void AddListener(string eventName, Actionobject callback) { if (_eventDict.ContainsKey(eventName)) _eventDict[eventName] callback; else _eventDict[eventName] callback; } public static void RemoveListener(string eventName, Actionobject callback) { if (_eventDict.ContainsKey(eventName)) _eventDict[eventName] - callback; } public static void Broadcast(string eventName, object data null) { if (_eventDict.ContainsKey(eventName)) _eventDict[eventName]?.Invoke(data); } }然后我们创建一个玩家金币显示的界面CoinPanel// CoinPanel.cs public class CoinPanel : BasePanelCoinPanel { private Text _coinText; private int _currentCoin; public override void InitPanel(...) { base.InitPanel(...); _coinText FindComponentText(CoinText); UpdateCoinDisplay(PlayerData.Instance.Coin); // 初始显示 // 监听金币变化事件 MessageCenter.AddListener(CoinChanged, OnCoinChanged); } private void OnCoinChanged(object newCoinObj) { if (newCoinObj is int newCoin) { _currentCoin newCoin; UpdateCoinDisplay(_currentCoin); } } private void UpdateCoinDisplay(int coin) { _coinText.text $金币: {coin}; } public override void OnClose() { base.OnClose(); // 关闭时移除监听防止内存泄漏 MessageCenter.RemoveListener(CoinChanged, OnCoinChanged); } }当游戏其他地方比如获得金币的脚本修改了金币数量只需要广播事件PlayerData.Instance.Coin 100; MessageCenter.Broadcast(CoinChanged, PlayerData.Instance.Coin);CoinPanel会自动更新显示完全解耦。这就是数据驱动UI更新的雏形。5. 进阶优化与常见问题排查一个基础的框架搭建起来了但要投入实际项目我们还需要考虑更多细节和优化点。同时开发过程中肯定会遇到各种问题这里我总结了一些常见的“坑”和解决方案。5.1 资源加载优化告别Resources.Load在ShowPanel方法中我们使用了Resources.Load。这在原型阶段没问题但对于正式项目Resources文件夹有诸多限制如路径依赖、内存管理不灵活、影响打包速度。强烈建议替换为AddressablesUnity 2018.3或AssetBundle系统。使用Addressables改造UIManager将UI预制体标记为Addressable。修改加载逻辑using UnityEngine.AddressableAssets; using UnityEngine.ResourceManagement.AsyncOperations; public async void ShowPanelAddressable(string panelName, ...) { if (_panelDict.ContainsKey(panelName)) { ... } string address $UI_{panelName}; // 你的Addressable地址 AsyncOperationHandleGameObject handle Addressables.LoadAssetAsyncGameObject(address); await handle.Task; if (handle.Status AsyncOperationStatus.Succeeded) { GameObject panelPrefab handle.Result; // ... 实例化等后续操作 // 注意通常需要记录这个handle在面板关闭时释放资源 // _handleDict[panelName] handle; } else { Debug.LogError($加载Addressable UI失败: {address}); Addressables.Release(handle); } } public void ClosePanelAddressable(string panelName) { if (_panelDict.TryGetValue(panelName, out BasePanel panel)) { panel.OnClose(); _panelDict.Remove(panelName); // 释放Addressable资源 if (_handleDict.TryGetValue(panelName, out AsyncOperationHandle handle)) { Addressables.Release(handle); _handleDict.Remove(panelName); } } }Addressables提供了更好的依赖管理、内存控制和远程加载能力是现代Unity项目资源管理的首选。5.2 UI性能优化要点UI是性能问题的重灾区框架层面可以做很多优化动静分离将频繁变化的UI元素如血量数字、计时器和静态UI元素如背景图放在不同的Canvas下。因为Canvas的任意子UI发生变化都会导致整个Canvas重建网格Rebuild。分离后静态Canvas不会重绘。对象池管理频繁开闭的界面对于像道具提示框、伤害飘字这类频繁打开关闭的界面不要每次都Instantiate/Destroy。可以在UIManager中实现一个简单的对象池隐藏时放回池子需要时取出复用。避免在Update中频繁操作UI不要在Update里每帧去查找组件或设置Text。对于需要每帧更新的数据可以在数据层每帧更新但通过事件或协程以较低频率如0.1秒一次通知UI更新。合理使用Canvas的Pixel Perfect和Raycast Target不必要的Pixel Perfect检查会增加开销。Image和Text默认会开启Raycast Target对于不需要接收点击事件的背景图等务必取消勾选能显著减少UI事件系统的计算量。5.3 常见问题与排查技巧问题1UI显示错位或大小异常。排查检查预制体根节点的RectTransform锚点Anchors和轴心点Pivot设置。在BasePanel.InitPanel中我们使用SetParent(parent, false)并重置了位置和缩放。确保你的预制体在设计时锚点设置正确通常为全拉伸Stretch或中心居中。技巧在预制体模式下设计UI时使用对齐工具Align快速设置锚点。对于需要适配不同屏幕的UI使用锚点和Canvas Scaler的Scale With Screen Size模式。问题2点击事件无响应。排查检查该层级的Canvas上是否有GraphicRaycaster组件。检查点击目标Image/Button/Text的Raycast Target是否勾选。是否有更上层的UI如全屏遮罩挡住了事件检查Canvas的Sort Order和渲染顺序。在复杂UI中可能有多个Raycaster事件被中途拦截。技巧使用Unity的EventSystem下的Raycast Result可视化工具或在运行时打印EventSystem.current.RaycastAll的结果来查看点击到了哪些对象。问题3打开多个界面后关闭时顺序或状态混乱。排查这通常是由于面板类型逻辑没处理好或导航栈缺失。我们的框架在HandlePanelTypeLogic中处理了独占界面。但对于普通的弹窗你可能还需要一个ListBasePanel来记录弹窗的打开顺序实现“后开先关”的堆栈逻辑。解决方案在UIManager中为PopUp类型维护一个栈Stack。打开弹窗时入栈关闭时出栈。当点击背景遮罩或按返回键时关闭栈顶的弹窗。问题4内存泄漏UI关闭后未被正确销毁。排查检查事件监听是否在OnClose或OnDestroy中移除。这是最常见的内存泄漏原因如我们的CoinPanel示例所示。检查是否对UI GameObject有静态引用或长时间存在的引用。如果使用了Addressables或AssetBundle检查资源句柄Handle是否在关闭时正确释放。技巧使用Unity Profiler的Memory模块查看GameObject和Object的残留情况。定期在编辑器中运行并强制进行垃圾回收GC观察内存是否下降。问题5UI动画与框架生命周期冲突。场景你为面板的打开/关闭添加了渐入渐出动画用协程或DOTween但在动画播放中途代码调用了ClosePanel直接销毁了对象导致动画协程报错或表现异常。解决方案在BasePanel中引入一个IsInTransition状态。在OnShow开始时设为true动画结束后设为false。在UIManager.ClosePanel中先检查panel.IsInTransition如果为true可以延迟关闭或者让面板动画结束后自己调用关闭方法通过回调。更优雅的方式是设计一个ITransition接口让动画控制器来管理显示隐藏的过渡过程。框架的搭建不是一蹴而就的它会在项目迭代中不断生长和优化。最开始可能只有最基础的显示隐藏功能随后你会加入动画系统、多语言支持、UI特效管理、编辑器拓展一键生成面板脚本等。重要的是你理解了这套架构的核心思想分离关注点、统一生命周期、降低耦合度。有了这个基础任何新增功能你都知道应该放在哪个模块如何与现有系统协作这才是从“会用框架”到“理解框架设计”的蜕变。