核心知识点技能界面 BasePanel 搭建、Excel 表格第三方库解析、StreamingAssets 与 Resources 区别、技能完整 XML/Excel 配置字段、枚举分类、文件 IO 读取、按职业筛选技能、通用 Item 预制复用、项目通用 UI 开发思路一、技能界面基础搭建1 概念独立技能弹窗面板继承通用 BasePanel 实现滑入动画底部功能栏增加技能按钮点击弹出对应职业技能列表结构逻辑和商店 / 背包完全统一。2 特性 / 规则整体 ScrollRect 竖直滚动列表GridLayout 自动排布技能条目单个技能预制统一包含图标、名称、技能描述、消耗蓝、技能类型文本打开面板时读取玩家职业筛选对应技能批量生成界面逻辑高度复用商店、背包代码结构一套模板适配所有列表 UI。3 语法 代码片段public class SkillPanel : BasePanel{ public RectTransform content; public GameObject skillItemPref; // 打开时根据玩家职业刷新列表 public override void Show(){ base.Show(); RefreshSkillList(PlayerStatus.Instance.JobType); } void RefreshSkillList(JobType job){ // 清空原有技能 foreach(Transform t in content) Destroy(t.gameObject); ListSkillInfo skillList SkillConfig.Instance.GetSkillByJob(job); foreach(var info in skillList){ GameObject item Instantiate(skillItemPref, content); item.GetComponentSkillItem().SetData(info); } } }4 相关知识点对比技能面板 VS 商店 / 背包面板底层结构完全一致ScrollGrid 预制 配置读取 唯一差异筛选条件商店按物品类型技能按职业。5 模块拓展技能 CD 预览、技能升级 UI、技能释放快捷栏。二、两种持久资源目录Resources VS StreamingAssets1 概念Unity 两个特殊资源文件夹资源打包处理、读取方式、文件格式保留规则完全不同Excel、视频、文本原始文件统一放 StreamingAssets。2 特性 / 规则Resources 打包时全部编译加密为二进制原始文件丢失 读取Resources.Load(路径) 适合贴图、预制、音效等引擎资源StreamingAssets 打包保留原始文件格式不加密、不转码 读取需要System.IO文件流拼接平台完整路径Application.streamingAssetsPath Excel、TXT、视频、外部配置原始文件专用限制编辑器运行、打包后路径写法存在平台差异不能用 Resources 加载。3 语法 代码片段// StreamingAssets完整路径拼接 string path Path.Combine(Application.streamingAssetsPath, SkillConfig.xlsx); FileStream fs File.Open(path, FileMode.Open, FileAccess.Read);4 相关知识点对比维度ResourcesStreamingAssets打包处理转为二进制加密保留原始文件读取方式Resources.LoadFile 文件流适用文件贴图 / 预制 / 音频Excel / 视频 / 外部原始配置5 模块拓展热更新外置配置、本地剧情文本、CG 视频统一放 StreamingAssets。三、Excel 技能配表完整字段设计1 概念Excel 作为策划可视化配置工具一张表存储全游戏所有技能数据包含基础信息、战斗属性、释放规则、特效动画共 17 项字段区分表头和数据行。2 特性 / 规则第一行为表头程序解析跳过从第二行开始读取有效数据所有枚举类型职业、技能类型、释放方式使用固定英文标识字段清单ID、技能名、图标资源、描述、作用类型、作用属性、数值、持续时间、耗蓝、CD、适用职业、解锁等级、释放类型、释放距离、特效名、动画名、动画时长禁止 WPS/Excel 同时占用文件否则文件流读取报错。3 配置示例表头 单行数据ID,name,icon,desc,effectType,attrType,value,duration,mpCost,cd,job,lv,castType,range,effectAnim,skillAnim,animTime 1001,火球,fire,单体火焰伤害,Single,Atk,80,3,20,5,Mage,1,SingleTarget,8,fireEff,fireSkill,1.24 相关知识点对比Excel VS JSON/XMLExcel策划可视化编辑批量修改便捷 JSON/XML程序解析简单不适合大量数值批量调整。5 模块拓展新增技能伤害系数、暴击率、套装联动字段。四、Excel 第三方库环境配置1 概念Unity 原生不支持 Excel 解析导入 NPOI/IExcelDataReader 三组 dll 放入 Plugins 文件夹引入对应命名空间实现表格读写。2 特性 / 规则Plugins 是引擎专用第三方库目录脚本自动优先编译必须导入完整配套 dll缺失会报读取类不存在解析核心命名空间ExcelDataReader、System.Data文件操作需要引入System.IO处理文件流。3 语法 代码片段using ExcelDataReader; using System.Data; using System.IO; // 打开Excel文件流 string filePath Application.streamingAssetsPath /SkillConfig.xlsx; FileStream stream File.Open(filePath, FileMode.Open, FileAccess.Read); using var reader ExcelReaderFactory.CreateReader(stream); DataSet dataSet new DataSet(); dataSet.Load(reader); // 获取第一张数据表 DataTable table dataSet.Tables[0];4 相关知识点对比无第三方库手写解析 VS NPOI 库手写只能拆分 CSV 文本无法解析 xlsx 表格 NPOI直接解析标准 Excel支持多工作表、行列索引读取。5 模块拓展Excel 写入功能、运行时动态修改配置存档。五、Excel 完整解析流程1 概念文件流打开 Excel→读取 DataSet 数据表→遍历数据行跳过表头→逐列读取字符串→转换对应数值 / 枚举→存入全局字典缓存。2 特性 / 规则行索引从 1 开始跳过表头第 0 行是标题单元格读取结果全部为 stringint、枚举需要强制转换竖线拼接整行调试打印方便核对配置解析完成关闭文件流释放文件占用。3 语法 代码片段// 遍历数据行跳过表头i0 for(int i 1; i table.Rows.Count; i){ DataRow row table.Rows[i]; SkillInfo info new SkillInfo(); info.id int.Parse(row[0].ToString()); info.skillName row[1].ToString(); info.jobType (JobType)Enum.Parse(typeof(JobType), row[9].ToString()); // 其余字段赋值... skillDict.Add(info.id, info); }4 相关知识点对比逐单元格直接读取 VS 拼接字符串调试直接读取业务逻辑高效出错难定位 拼接打印开发阶段快速核对配置是否读取正确。5 模块拓展配置热重载、运行时重新加载 Excel 更新技能数据。六、SkillInfo 实体与枚举定义1 概念实体类一对一映射 Excel 全部字段枚举统一约束技能分类避免字符串硬编码出错。2 特性规则枚举技能作用类型、属性类型、释放类型、适用职业实体字段与 Excel 列顺序一一对应全局字典Dictionaryint, SkillInfo以技能 ID 为键缓存所有配置。3 语法 代码片段// 技能作用类型 public enum SkillEffectType { Single, AOE, Buff } // 技能实体 public class SkillInfo{ public int id; public string skillName; public string iconPath; public SkillEffectType effectType; public int mpCost; public float cdTime; public JobType fitJob; } // 全局配置单例 public class SkillConfig{ public static SkillConfig Instance; private Dictionaryint, SkillInfo skillDict new(); // 根据ID获取 public SkillInfo GetById(int id){ skillDict.TryGetValue(id, out var res); return res; } // 根据职业筛选全部技能 public ListSkillInfo GetSkillByJob(JobType job){ ListSkillInfo list new(); foreach(var kv in skillDict){ if(kv.Value.fitJob job) list.Add(kv.Value); } return list; } }4 相关知识点对比枚举标识 VS 硬编码字符串枚举编译校验拼写错误直接报错 字符串运行时才发现错误排错成本高。5 模块拓展技能等级多配置表、技能前置解锁条件。七、技能 Item 条目渲染逻辑1 概念单个技能预制挂载 SkillItem 脚本接收 SkillInfo 填充图标、名称、描述、耗蓝、技能类型文本。2 特性 / 规则图标从 Resources 读取贴图枚举转中文文本展示给玩家界面完全复用商店 Item 代码架构。3 语法 代码片段public class SkillItem{ public Image iconImg; public Text nameTxt; public Text descTxt; public Text mpTxt; public void SetData(SkillInfo info){ iconImg.sprite Resources.LoadSprite(SkillIcon/ info.iconPath); nameTxt.text info.skillName; mpTxt.text $消耗蓝量{info.mpCost}; // 枚举转中文描述 string typeStr info.effectType switch{ SkillEffectType.Single 单体伤害, SkillEffectType.AOE 群体范围, SkillEffectType.Buff 增益效果 }; descTxt.text $技能类型{typeStr}\n{info.desc}; } }4 相关知识点对比硬编码中文 VS 枚举匹配转换硬编码多处重复文字修改需全量替换 枚举 switch 统一转换一处维护。5 模块拓展技能 CD 遮罩、可学习高亮区分未解锁技能。八、项目通用 UI 开发标准化思路1 概念背包 / 商店 / 装备 / 技能四类列表界面底层架构完全统一形成固定开发模板大幅减少重复编码。2 固定开发模板流程弹窗继承 BasePanel实现 Show 刷新ScrollGridLayout 布局条目预制新建对应 Config 配置单例解析外部配表封装按类型 / 职业筛选接口条目脚本 SetData 渲染配置功能按钮点击刷新列表。3 相关知识点对比每个界面重新设计 VS 复用统一模板重新开发大量重复布局、加载、销毁代码 统一模板只修改配置实体和筛选逻辑开发效率翻倍。5 模块拓展商城、任务、成就全部复用该模板。综合拓展1 技能系统完整业务流程StreamingAssets 存放 Excel 技能配表→NPOI 解析表格→字典缓存所有技能→打开技能面板读取玩家职业→筛选对应技能批量实例条目→渲染图标 / 名称 / 耗蓝 / 类型2 高频 Bug 排查清单Excel 读取失败WPS 占用文件、dll 缺失、路径写错技能列表为空职业枚举字符串不匹配、表头未跳过贴图空白Resources 图标路径和 Excelicon 字段不一致打包文件找不到误用 Resources 读取 StreamingAssets3 核心考点StreamingAssets 与 Resources 区别、Excel 第三方库解析流程、技能多条件筛选、通用列表 UI 模板、配表实体枚举设计4 进阶拓展学习方向技能释放战斗逻辑、CD 计时器、技能升级配表、外置热更新 Excel、技能快捷键栏5 实战落地要求整合背包 / 商店 / 装备 / 技能四大 UI 模块统一配表解析架构写入 RPG 项目。
