FairyGUI：编辑器、组件、动效与引擎运行库

依据：官方文档与本站教学拆解｜环境：FairyGUI 官方 SDK 分类与 Creator 接入；具体版本需匹配｜真机：未验证

FairyGUI 是一套 UI 编辑与运行体系。设计者在独立编辑器里组织组件、布局和动效，发布后由对应 SDK 在游戏中创建界面。它提供 UI 工作流，不是一个独立的微信小游戏宿主；最终仍需目标引擎或渲染环境负责应用运行与发布。

两个工程各管什么

UI 工程保存界面结构、图片、关系、控制器和动效；游戏工程保存业务状态、游戏逻辑、平台接口和资源加载策略。发布的 UI 包把两者连接起来。UI 包通常包含界面描述与纹理资源，游戏侧加载后创建具体组件，并绑定数据和事件。

控制器可以表达组件的可见状态或页面切换；关联和布局帮助维持尺寸关系；列表和动效减少重复搭建工作。业务脚本仍然要决定什么时候进入“领取中”、如何处理请求失败、关闭时取消什么任务。编辑器中的视觉状态不等于完整业务状态机。

官方站点区分官方 SDK 与社区维护 SDK，接入前要确认自己选择的版本、维护方和引擎版本。Creator 接入文档中有历史 API 示例，不能把旧版 cc.loader 代码当作 Cocos 3.8 的可直接运行范例。正确方式是选定 SDK 分支，先运行它自带的对应版本示例。

“FairyGUI 支持某引擎”仍不是完整的微信兼容性结论。还应核对该引擎的微信构建、文字与字体、遮罩、材质、资源加载和动画特性，以及使用中的 SDK 是否覆盖这些行为。

界面实例可能继续引用包里的纹理、字体或其他对象。若包已卸载却仍显示或等待回调，可能出现缺图、空白或生命周期错误。应先销毁或脱离界面实例、取消事件与异步工作，再按资源管理规则释放包。频繁加载卸载也有成本，常用 UI 可以按测量结果驻留。

当项目有大量结构相近的页面、设计人员需要直接维护 UI、控制器与复杂列表很多时，独立 UI 工具可能显著改变协作方式。界面很少或团队已有成熟的引擎预制体流程时，也应评估额外编辑器、资源发布、SDK 升级和调试链路的维护成本。

可以用同一个背包案例比较两条流程：引擎原生组件和 FairyGUI。记录从修改一行布局到看到目标效果需要哪些步骤，连同运行性能一起评估，而不是只看搭界面速度。

FairyGUI 下载与运行库分类、Creator SDK 接入、官方 Creator SDK 仓库。这些资料用于确认工作流与接入条件，官方旧教程中的 API 和包大小不作为本站当前版本保证。