1. 项目概述为什么选择FairyGUI来构建动态列表如果你在Unity项目里被UGUI的列表性能、动态更新或者复杂排版折磨过那么FairyGUI这个工具你一定不陌生。作为一个在多个项目里深度使用过FairyGUI的开发者我最初也是被它“编辑器与运行时分离”的设计理念所吸引。这次我们不谈空泛的概念直接聚焦一个高频且棘手的场景在Unity中快速、高效地构建动态列表UI。动态列表是什么简单说就是数据量不确定、内容需要频繁刷新比如聊天记录、背包物品、排行榜的列表。用UGUI的ScrollRectContent Size FitterGrid Layout Group组合数据量一上去卡顿和内存问题就接踵而至。FairyGUI的列表组件GList从底层设计上就为动态加载和虚拟化做了优化它通过对象池管理列表项只渲染可视区域内的项性能提升是立竿见影的。更重要的是它的工作流是“所见即所得”的。你在FairyGUI编辑器中设计好一个列表项ListItem的样式发布成Unity可用的资源包bundle。在Unity中你几乎不需要手动拼UI只需要关注数据逻辑绑定数据源、处理渲染回调。这种将UI美术资源与程序逻辑解耦的方式极大地提升了团队协作效率和迭代速度。接下来我会用一个从零开始的完整示例带你走通整个流程并分享那些官方文档里不会写的“踩坑”经验。2. 核心思路与FairyGUI编辑器准备在动手写代码之前我们必须先在FairyGUI编辑器中完成UI资源的设计。这是FairyGUI工作流的核心也是与传统UGUI开发思维最大的不同点UI是美术或策划在专用编辑器中生产的“资源”而不是程序员在Unity场景中拖拽的GameObject。2.1 创建列表项ListItem组件首先打开FairyGUI编辑器创建一个新的“组件”。这个组件就是我们动态列表中每一个单元的模板。假设我们要做一个简单的消息列表每条消息包含头像、发送者名称、消息内容和时间。组件设计在编辑器中你可以像使用任何图形设计软件一样拖拽各种基础控件图片、文本、按钮等到画布上。为我们的消息项设计如下结构一个n0_head头像GLoader类型一个n1_name发送者GTextField类型一个n2_content消息内容GTextField类型支持多行一个n3_time时间GTextField类型 你需要为这些控件设置好初始大小、位置并给它们起一个清晰易懂的名称Name。这个名称至关重要它是后续在代码中获取该控件的唯一标识。发布设置设计完成后点击发布Publish。FairyGUI会将组件、图片、字体等资源打包成一个或多个资源包bundle并生成一个描述UI结构的描述文件.xml或.fui。你需要确保发布路径指向你的Unity项目的Resources目录或AssetBundle的特定目录这样Unity才能加载到这些资源。注意在编辑器中务必使用“测试”功能预览列表项的实际效果。检查文本控件的自动换行、富文本设置是否正确图片控件的填充类型FillMethod是否合适。这些在编辑器里调好能避免99%的运行时显示问题。2.2 理解FairyGUI的列表GList核心机制FairyGUI的GList组件是动态列表的灵魂。它与UGUI的ScrollRect有本质区别虚拟化VirtualizationGList默认支持虚拟列表。这意味着即使你的数据源有1000条数据GList也只会创建足够覆盖当前滚动区域viewport的列表项实例。当滚动时它会通过一个叫itemRenderer的回调函数循环使用这些实例为它们设置新的数据。这从根本上解决了大量UI对象带来的性能开销。对象池Object PoolGList内部维护了一个列表项的对象池。当一个列表项滚动出视野它不会被销毁而是被回收到池子里等待下一个需要显示的数据项来复用。这避免了频繁的Instantiate和Destroy操作。多样化的布局GList支持单列、单行、流式布局瀑布流、分页布局等多种排列方式且布局计算效率很高无需像UGUI那样依赖耗时的Canvas.SendWillRenderCanvases。理解了这些我们就知道代码的核心任务就是配置好GList然后实现一个itemRenderer方法将数据“刷”到复用的列表项控件上。3. Unity工程集成与基础环境搭建将FairyGUI编辑器发布的资源成功导入Unity并建立正确的加载机制是项目跑起来的第一步。这里有几个关键点容易出错。3.1 资源导入与UIPanel配置导入运行时库与资源从FairyGUI官网下载Unity SDKUIPackage将其导入你的Unity工程。同时确保编辑器发布的资源通常是fairygui文件夹里面包含二进制包文件和图集等也被放到了Unity项目的Assets目录下例如Assets/Resources或你自己规划的AssetBundle目录。创建UI视图在Unity场景中创建一个空GameObject为其添加UIPanel组件。这是FairyGUI UI根容器在Unity中的代表。在UIPanel的Package Name和Component Name下拉框中分别选择你刚刚发布的UI包名和主组件名比如你创建了一个名为MessageListView的组件作为列表的容器。勾选Fit Size和Touch Disabled等选项让UI自适应屏幕并处理点击事件。获取GList引用我们需要在代码中获取到这个UIPanel下的GList组件。通常我们会在一个挂载在该GameObject上的C#脚本中通过UIPanel.ui这个属性来获取FairyGUI的根视图进而查找其中的GList。using FairyGUI; using UnityEngine; public class MessageListWindow : MonoBehaviour { private GList _messageList; void Start() { // 方式1通过UIPanel获取 UIPanel panel GetComponentUIPanel(); if (panel ! null) { GComponent view panel.ui; _messageList view.GetChild(“list_message”) as GList; // “list_message”是你在编辑器中为列表控件起的名字 } // 方式2动态创建UI如果不使用场景中的UIPanel // GComponent view UIPackage.CreateObject(“PackageName”, “ComponentName”) as GComponent; // _messageList view.GetChild(“list_message”) as GList; // GRoot.inst.AddChild(view); // 添加到舞台 if (_messageList null) { Debug.LogError(“未能找到消息列表GList请检查控件名称”); return; } InitializeList(); } void InitializeList() { // 列表初始化配置将在这里进行 } }实操心得强烈建议在FairyGUI编辑器中为所有需要代码访问的控件设置一个有意义的、唯一的名称而不是使用默认的n0,n1。使用list_message、btn_submit这样的名称能极大提高代码的可读性和可维护性。通过GetChild(“控件名”)来获取控件引用是最可靠的方式。3.2 列表初始化与数据模型定义在InitializeList方法中我们需要对GList进行关键配置并定义我们的数据模型。// 数据模型类代表一条消息 public class MessageData { public string headIconUrl; // 头像URL或资源ID public string senderName; public string content; public string time; // 可以扩展其他字段如消息ID、类型等 } private ListMessageData _dataList new ListMessageData(); // 数据源 void InitializeList() { // 1. 设置列表的渲染回调函数这是核心 _messageList.itemRenderer OnRenderListItem; // 2. 设置列表项ListItem的提供者。这里我们使用FairyGUI编辑器中创建的组件作为模板。 // “MessageListItem”是你在FairyGUI编辑器中创建的那个列表项组件的名称。 _messageList.itemProvider OnRequestListItem; // 3. 设置列表为垂直滚动布局 _messageList.SetVirtual(); // 启用虚拟布局 _messageList.numItems 0; // 初始数据项数为0后续通过_numItems控制 // 4. 可选添加点击事件监听 _messageList.onClickItem.Add(OnClickMessageItem); }itemRenderer是列表的“绘画笔”。每当一个列表项需要被显示或刷新时这个回调函数就会被调用。itemProvider则告诉列表当需要创建一个新的列表项实例时应该使用哪个UI组件作为模板。SetVirtual()是启用虚拟列表的关键。4. 核心实现数据驱动与列表项渲染这是整个动态列表功能最核心的部分我们将实现itemProvider和itemRenderer并处理数据的增删改查。4.1 实现ItemProvider与ItemRenderer// ItemProvider: 当列表需要创建新的项时返回一个列表项的资源URL private string OnRequestListItem(int index) { // 返回在FairyGUI编辑器中创建的列表项组件资源ID。 // 格式为“包名组件名”如果组件在包根目录也可以直接写“组件名”。 // 这里我们假设列表项组件名为“MessageListItem”它位于当前UI包内。 return “MessageListItem”; } // ItemRenderer: 核心渲染逻辑将数据绑定到UI控件上 private void OnRenderListItem(int index, GObject itemObj) { // 1. 安全检查 if (index 0 || index _dataList.Count) return; // 2. 获取当前需要渲染的数据 MessageData data _dataList[index]; // 3. itemObj就是由OnRequestListItem提供的组件实例将其转换为GComponent以便获取子控件 GComponent itemComp itemObj as GComponent; // 4. 通过控件名称获取列表项内的各个子控件并设置数据 GLoader headLoader itemComp.GetChild(“n0_head”) as GLoader; GTextField nameText itemComp.GetChild(“n1_name”) as GTextField; GTextField contentText itemComp.GetChild(“n2_content”) as GTextField; GTextField timeText itemComp.GetChild(“n3_time”) as GTextField; if (headLoader ! null) { // 设置头像。如果是网络图片可以使用headLoader.url data.headIconUrl; // 如果是包内资源使用UIPackage.GetItemURL headLoader.url UIPackage.GetItemURL(“YourPackageName”, data.headIconUrl); // 或者直接使用资源名如果图片已发布在图集中 // headLoader.icon data.headIconUrl; } if (nameText ! null) nameText.text data.senderName; if (contentText ! null) contentText.text data.content; if (timeText ! null) timeText.text data.time; // 5. 可以根据数据状态动态改变控件属性例如自己发送的消息背景色不同 if (data.senderName “我”) { itemComp.GetChild(“bg”).asGraph.color new Color(0.8f, 0.9f, 1.0f); } }OnRenderListItem这个函数会在两种情况下被调用一是列表项首次进入视野时二是列表项的数据需要更新时比如调用了RefreshVirtualList。它的执行频率很高因此务必保证这个函数内的逻辑高效。避免在这里进行复杂的计算、频繁的字符串拼接或实例化操作。4.2 数据操作与列表更新有了渲染函数我们就可以通过操作_dataList和_messageList.numItems来驱动UI变化。// 添加一条新消息到列表顶部类似聊天 public void AddMessage(MessageData newMsg) { _dataList.Insert(0, newMsg); // 插入到数据源开头 _messageList.numItems _dataList.Count; // 必须更新numItems以通知列表数据量变化 // 由于是插入到顶部我们希望列表滚动到最新位置 _messageList.ScrollToView(0); // 如果列表项高度不固定需要刷新列表布局计算 // _messageList.RefreshVirtualList(); } // 删除一条消息 public void RemoveMessage(int index) { if (index 0 index _dataList.Count) { _dataList.RemoveAt(index); _messageList.numItems _dataList.Count; // 删除后列表会自动处理项的回收和重新排列 } } // 更新一条消息例如修改了内容 public void UpdateMessage(int index, MessageData newData) { if (index 0 index _dataList.Count) { _dataList[index] newData; // 方法A直接刷新整个列表简单但可能不够高效 // _messageList.RefreshVirtualList(); // 方法B仅刷新指定索引的项更高效推荐 _messageList.RefreshVirtualList(index, index); } } // 清空列表 public void ClearAllMessages() { _dataList.Clear(); _messageList.numItems 0; }关键点在于任何对数据源_dataList的增删改操作都必须同步更新_messageList.numItems。numItems是GList知道当前有多少数据项需要渲染的唯一依据。RefreshVirtualList()方法会强制列表重新调用所有可视项的itemRenderer用于数据更新后的UI刷新。4.3 处理列表项点击与自定义事件动态列表的交互必不可少。FairyGUI的GList提供了onClickItem事件可以方便地捕获列表项的点击。private void OnClickMessageItem(EventContext context) { // 通过context.data可以获取到被点击的列表项对象 GObject clickedItem context.data as GObject; // 通过clickedItem.parent可以获取到GList进而通过GList.ItemIndexToChildIndex计算索引 // 但更简单的方式是在渲染时就将索引存储在列表项的自定义数据里 int clickedIndex _messageList.GetChildIndex(clickedItem); int itemIndex _messageList.ChildIndexToItemIndex(clickedIndex); Debug.Log($“点击了第{itemIndex}项发送者{_dataList[itemIndex].senderName}”); // 触发更具体的业务逻辑比如打开详情页、回复消息等 OnMessageSelected?.Invoke(_dataList[itemIndex]); }对于更复杂的交互比如列表项内部有一个删除按钮你需要在OnRenderListItem中为那个按钮单独添加点击监听器并注意事件冒泡和对象引用的问题。private void OnRenderListItem(int index, GObject itemObj) { // ... 之前的渲染代码 ... GButton deleteBtn itemComp.GetChild(“btn_delete”) as GButton; if (deleteBtn ! null) { // 移除旧的监听器避免重复添加重要 deleteBtn.onClick.Clear(); // 添加新的监听器利用闭包捕获当前索引 int currentIndex index; // 注意index参数可能因复用而变化需要捕获 deleteBtn.onClick.Add(() OnDeleteButtonClicked(currentIndex)); } } private void OnDeleteButtonClicked(int itemIndex) { Debug.Log($“请求删除第{itemIndex}项”); RemoveMessage(itemIndex); }注意事项在itemRenderer中为动态创建的控件如按钮添加事件监听时务必先清除Clear()旧的事件监听。因为itemRenderer会被反复调用同一个按钮对象可能被复用来渲染不同的数据项如果不清理会导致同一个按钮上绑定了多个事件处理器引发意想不到的bug。5. 性能优化与高级技巧基础功能实现后我们还需要关注性能和更复杂的需求。FairyGUI的列表虽然高效但使用不当也会成为性能瓶颈。5.1 列表项复用与状态管理陷阱虚拟列表的核心是复用。这意味着第10个列表项的对象在滚动后可能被用来显示第50条数据。这带来一个常见问题状态残留。假设你的列表项有一个选中状态高亮背景。当你选中第1项然后快速滚动到第100项可能会发现第100项也被高亮了。这是因为代表第1项的UI对象被复用来显示第100项的数据了但它的选中状态没有被重置。解决方案在itemRenderer中必须完整地、无条件地根据当前index对应的data来设置列表项所有控件的状态。不能假设控件还保持着上一次渲染时的状态。private void OnRenderListItem(int index, GObject itemObj) { // ... 获取数据和控件 ... // 设置内容 nameText.text data.senderName; // 重置状态例如无论数据如何先取消高亮 GGraph selectedBg itemComp.GetChild(“selected_bg”) as GGraph; if (selectedBg ! null) { // 根据当前数据是否是选中项来设置显示状态而不是依赖控件之前的状态 selectedBg.visible (index _currentlySelectedIndex); } // 如果有其他动态状态如图标、颜色都要在这里根据data重新设置 }5.2 异步加载与占位符处理如果列表项中包含网络图片如头像直接在主渲染循环中加载会阻塞UI。FairyGUI的GLoader组件支持异步加载但我们需要更好的加载策略。使用协程或异步任务在OnRenderListItem中不要直接调用同步的加载方法。可以为GLoader设置一个占位图然后启动一个协程来异步加载网络图片加载完成后替换。实现简单的图片加载管理器管理一个加载队列和缓存如使用Dictionarystring, Texture2D避免同一张图片重复加载。在OnRenderListItem中先检查缓存命中则直接设置未命中则加入加载队列。处理快速滚动时的加载取消当用户快速滚动时很多刚刚发起的图片加载请求可能已经对应的列表项已经滚出视野。此时继续加载是浪费。可以在GList的scrollEvent或itemRenderer中判断当前项是否还在可视区域内如果不在则取消该图片的加载请求。// 伪代码示例在渲染函数中启动异步加载 private async void OnRenderListItem(int index, GObject itemObj) { // ... 其他渲染 ... GLoader headLoader itemComp.GetChild(“n0_head”) as GLoader; string url _dataList[index].headIconUrl; headLoader.url “ui://包名/占位图”; // 先显示占位图 // 将加载任务与当前索引、控件关联以便取消 var loadTask LoadHeadIconAsync(url, headLoader, index); // 存储或管理这个task在项被回收或索引不匹配时取消它 } private async Task LoadHeadIconAsync(string url, GLoader loader, int targetIndex) { // 模拟异步加载 Texture2D tex await YourNetworkManager.LoadTextureAsync(url); // 加载完成后再次检查这个loader是否还在显示当初请求的那个索引的数据 // 可以通过在loader上存储一个自定义数据如loader.data targetIndex来比对 if (loader ! null (int)loader.data targetIndex) { loader.texture new NTexture(tex); // 将Texture2D转换为FairyGUI的NTexture } }5.3 复杂列表项与自定义ItemRenderer当列表项结构非常复杂或者有大量交互逻辑时将全部逻辑写在主控脚本的OnRenderListItem里会变得臃肿且难以维护。这时可以为每个列表项类型创建一个独立的脚本。在FairyGUI编辑器中为列表项组件设置“自定义扩展类”。在Unity中创建一个继承自GComponent的C#类例如MessageListItem。在这个类中声明所有子控件的引用并实现一个SetData(MessageData data)方法。// FairyGUI编辑器 - 组件属性 - 自定义扩展类填写“MessageListItem” public class MessageListItem : GComponent { public GLoader headLoader; public GTextField nameText; // ... 其他控件引用 // FairyGUI回调当组件构建完成时调用 protected override void ConstructFromXML(FairyGUI.Utils.XML xml) { base.ConstructFromXML(xml); // 在这里获取子控件引用与之前GetChild逻辑一致 headLoader GetChild(“n0_head”) as GLoader; nameText GetChild(“n1_name”) as GTextField; // ... } public void SetData(MessageData data) { // 在这里实现数据绑定逻辑 nameText.text data.senderName; // ... 甚至可以在这里处理按钮事件 GetChild(“btn_reply”).asButton.onClick.Set(() { /* 回复逻辑 */ }); } }然后在主列表的OnRenderListItem中代码会变得非常简洁private void OnRenderListItem(int index, GObject itemObj) { MessageListItem itemComp itemObj as MessageListItem; // 直接转换 if (itemComp ! null) { itemComp.SetData(_dataList[index]); } }这种方式将列表项自身的视图逻辑封装了起来符合组件化思想主列表控制器只负责调度和数据源管理代码结构清晰易于复用和测试。6. 常见问题排查与调试实录在实际开发中你肯定会遇到一些“诡异”的问题。下面是我总结的几个高频问题及其解决方法。6.1 列表不显示或显示异常问题现象可能原因排查步骤与解决方案列表一片空白无任何项显示。1.numItems设置为0或数据源为空。2. 列表项组件资源路径错误itemProvider返回空或错误URL。3. 列表的foldInvisibleItems属性被误开启。1. 检查_dataList.Count和_messageList.numItems是否大于0。2. 在OnRequestListItem中打印或返回一个绝对正确的资源ID如UIPackage.GetItemURL(“包名”, “组件名”)。3. 在FairyGUI编辑器中检查列表属性或代码中设置_messageList.foldInvisibleItems false。列表有滚动条但项都堆叠在一起或位置不对。1. 未调用SetVirtual()或设置了错误的布局。2. 列表项ListItem的高度/宽度为0或不固定且未正确设置itemSize或defaultItemSize。3.itemRenderer中修改了列表项的大小但未通知列表重新布局。1. 确认调用了_messageList.SetVirtual()并设置了layout如ListLayoutType.SingleColumn。2. 如果列表项高度不固定如文本换行需在itemRenderer中设置好文本后调用itemObj.height itemObj.textField.textHeight 20;示例并设置_messageList.itemSize Vector2.zero;和_messageList.autoResizeItem true;。3. 在修改项尺寸后调用_messageList.RefreshVirtualList(index, index)刷新该行。列表项显示错乱数据A显示在了数据B的UI上。这是典型的复用状态未重置问题。itemRenderer中没有根据当前数据完整更新所有控件状态。严格遵循第5.1节的建议。在itemRenderer中像对待一个全新的UI对象一样设置每一个需要显示的控件的内容和状态不要依赖任何“默认”或“上一次”的状态。对于布尔状态如选中、已读要显式地设置为true或false。6.2 交互与事件相关问题点击无反应首先检查UIPanel或根GComponent的touchable属性是否为true。其次检查列表项或其内部按钮的touchable和grayed状态。使用FairyGUI编辑器提供的“调试模式”或代码中输出点击事件日志来定位。事件触发多次如4.3节所述在动态绑定的itemRenderer中为按钮等控件添加事件监听前必须调用onClick.Clear()。这是最常见的原因。滚动卡顿即使在虚拟列表下如果itemRenderer函数执行太慢如包含同步的IO操作、复杂计算也会导致滚动卡顿。务必优化itemRenderer内的逻辑将耗时操作如图片加载异步化并利用缓存。6.3 内存管理与资源泄漏FairyGUI的对象GObject大部分由内部对象池管理但如果你在代码中持有了对GObject的强引用且未在适当的时候释放可能会导致内存泄漏。避免在全局容器中持有GObject引用不要将列表项GComponent或其中的子控件长期保存在一个全局的List或Dictionary中除非你非常清楚它们的生命周期。当列表项被回收后这些引用会阻止对象被正确销毁。及时清理事件监听除了在itemRenderer中清理在持有UI的脚本如窗口被销毁时也应清理其绑定的全局事件。GList.onClickItem.Remove(...)。注意UIPackage的卸载如果你动态加载和卸载UI包确保在卸载包UIPackage.RemovePackage前所有引用该包内资源的UI都被正确销毁从显示列表移除并置空引用。7. 完整代码示例与项目结构建议最后我将一个整合了上述所有要点的、可直接运行的示例脚本提供如下。这个脚本假设你已经按照前文在FairyGUI编辑器中创建了名为MessageListWindow的主界面组件内含一个名为list_message的列表和名为MessageListItem的列表项组件。using System.Collections.Generic; using FairyGUI; using UnityEngine; public class MessageListDemo : MonoBehaviour { // 在Inspector中拖拽赋值或通过代码动态创建 public UIPanel uiPanel; private GList _messageList; private ListMessageData _dataList new ListMessageData(); private int _currentlySelectedIndex -1; void Start() { if (uiPanel null) uiPanel GetComponentUIPanel(); if (uiPanel ! null uiPanel.ui ! null) { InitializeListView(uiPanel.ui); // 模拟添加一些测试数据 AddTestData(); } else { Debug.LogError(“UIPanel未设置或UI未创建成功”); } } void InitializeListView(GComponent rootView) { // 1. 获取列表引用 _messageList rootView.GetChild(“list_message”) as GList; if (_messageList null) { Debug.LogError(“主界面中未找到名为’list_message’的列表”); return; } // 2. 配置列表 _messageList.SetVirtual(); // 启用虚拟列表 _messageList.itemRenderer OnRenderListItem; _messageList.itemProvider OnRequestListItem; _messageList.numItems 0; _messageList.onClickItem.Add(OnClickListItem); // 3. 可选设置滚动条、间距等 _messageList.scrollItemToViewOnClick false; _messageList.lineGap 5; // 行间距 } string OnRequestListItem(int index) { // 返回列表项的资源ID return “MessageListItem”; } void OnRenderListItem(int index, GObject itemObj) { if (index 0 || index _dataList.Count) return; MessageData data _dataList[index]; GComponent itemComp itemObj as GComponent; // 获取控件 - 这里假设控件名称与编辑器内一致 GLoader headLoader itemComp.GetChild(“n0_head”) as GLoader; GTextField nameText itemComp.GetChild(“n1_name”) as GTextField; GTextField contentText itemComp.GetChild(“n2_content”) as GTextField; GTextField timeText itemComp.GetChild(“n3_time”) as GTextField; GGraph selectedBg itemComp.GetChild(“selected_bg”) as GGraph; // 设置数据 if (headLoader ! null) { // 示例使用包内资源实际项目可能是网络图片 headLoader.url UIPackage.GetItemURL(“YourUIPackageName”, data.headIconUrl); } if (nameText ! null) nameText.text data.senderName; if (contentText ! null) contentText.text data.content; if (timeText ! null) timeText.text data.time; // 重置并设置状态选中背景 if (selectedBg ! null) { selectedBg.visible (index _currentlySelectedIndex); } // 处理内部按钮事件例如删除按钮 GButton deleteBtn itemComp.GetChild(“btn_delete”) as GButton; if (deleteBtn ! null) { deleteBtn.onClick.Clear(); // 关键清除旧监听 int currentIndex index; // 捕获当前索引 deleteBtn.onClick.Add(() OnDeleteButtonClicked(currentIndex)); } } void OnClickListItem(EventContext context) { GObject clickedItem context.data as GObject; int clickedIndex _messageList.GetChildIndex(clickedItem); int itemIndex _messageList.ChildIndexToItemIndex(clickedIndex); if (itemIndex 0 itemIndex _dataList.Count) { _currentlySelectedIndex itemIndex; // 刷新列表以更新选中状态显示 _messageList.RefreshVirtualList(); Debug.Log($“选中了消息{_dataList[itemIndex].senderName}”); } } void OnDeleteButtonClicked(int itemIndex) { Debug.Log($“删除消息索引{itemIndex}”); RemoveMessage(itemIndex); } // --- 数据操作接口 --- public void AddMessage(MessageData msg) { _dataList.Insert(0, msg); _messageList.numItems _dataList.Count; _messageList.ScrollToView(0); // 如果列表项高度可变可能需要刷新 // _messageList.RefreshVirtualList(); } public void RemoveMessage(int index) { if (index 0 || index _dataList.Count) return; _dataList.RemoveAt(index); _messageList.numItems _dataList.Count; // 如果删除的是选中项清空选中状态 if (index _currentlySelectedIndex) _currentlySelectedIndex -1; } public void UpdateMessage(int index, MessageData newData) { if (index 0 || index _dataList.Count) return; _dataList[index] newData; _messageList.RefreshVirtualList(index, index); // 高效地只刷新一项 } public void ClearAllMessages() { _dataList.Clear(); _currentlySelectedIndex -1; _messageList.numItems 0; } // --- 测试数据 --- void AddTestData() { for (int i 0; i 50; i) { _dataList.Add(new MessageData() { headIconUrl “head_” (i % 5), // 假设有5种头像 senderName “用户” i, content “这是一条测试消息索引为 #” i “。动态列表的性能至关重要。”, time System.DateTime.Now.AddMinutes(-i).ToString(“HH:mm”) }); } _messageList.numItems _dataList.Count; } } // 数据模型 public class MessageData { public string headIconUrl; public string senderName; public string content; public string time; }项目结构建议/Scripts/UI/存放所有UI相关的C#脚本如MessageListDemo、MessageListItem如果用了自定义组件。/Resources/FairyGUI/存放FairyGUI编辑器发布的所有资源包_fui文件、图集等。职责分离将纯粹的数据管理如_dataList的增删改查、视图渲染逻辑OnRenderListItem和业务逻辑如网络请求、删除确认尽可能分离。MessageListDemo应主要充当视图控制器Controller。使用事件/委托解耦列表控制器不应该直接调用游戏核心逻辑。可以通过定义事件如public event ActionMessageData OnMessageSelected来通知其他系统保持代码的灵活性和可测试性。经过以上步骤一个高性能、易维护的FairyGUI动态列表就已经构建完成了。关键在于理解其“数据驱动”和“对象池复用”的核心理念并在itemRenderer中做好状态管理。这套方案足以应对项目中绝大多数列表需求从简单的消息流到复杂的装备背包都能游刃有余。
