直接把干货放前面这个方案的核心思路是用EPPlus在Unity里直接解析Excel文件把工作表中的每一行变成一个题目对象再塞进运行时用的题目列表。适用场景很明确——策划或内容人员习惯用Excel维护题库程序这边不想为了几百道题去搞一套后台管理系统也不想手工转Json再维护两份数据。我最早是在某个模拟项目X里接的这个需求当时给某跨平台系统做知识问答模块内容量不大但迭代频繁用这套流程下来从Excel到游戏内可用的题库全程可以控制在几分钟内完成。1. 为什么不再手工转换题库数据先说说很多人常走的两条老路以及它们的问题在哪里。最原始的做法是程序直接对着Excel手工抄数据在代码里写死一个List或者数组。这种做法在题目数量少于20道时问题不大但一旦超过50道维护体验就会非常糟糕。策划改一道题的选项顺序程序就要在代码里翻半天还要小心别把中文标点弄丢更别说Excel里偶尔出现的换行符会被直接吃掉。另一条常见路线是把Excel另存为CSV然后用Unity的TextAsset读取。CSV方案虽然解决了“程序不用打开Excel”的问题但CSV的先天缺陷很致命逗号和换行符会让字段错位Excel里的公式只有值没有原始逻辑而且中文编码在不同的Unity版本下还会出现乱码。更难受的是CSV没法携带额外的格式信息比如题干图片路径、答案解释的富文本标记这些都要另想办法塞进一个字段里时间长了非常痛苦。EPPlus方案的好处在于它直接以Excel文件为数据源程序员不需要关心CSV转义也不需要额外维护Json。Excel本身就是编辑界面策划可以加批注、调格式、做下拉校验这些元信息程序不用全读但至少不会被文件格式破坏。从工程角度看这是“数据编辑体验”和“程序读取效率”之间一个很现实的平衡点。1.1 为什么选EPPlus而不是其他读取库Unity生态里处理Excel的库不算多我简单对比过几种方案。NPOI是Apache POI的.NET移植版免费且流行但NPOI的API风格非常古老读写Excel 2007以上格式时性能一般还有一堆以“HSSF”和“XSSF”命名的类新手看到直接劝退。ClosedXML的API很现代但它依赖.NET Standard 2.0而且导包以后体积偏大。EPPlus在NuGet上的热度长期靠前社区活跃度明显更好API的设计也比较贴近Excel的对象模型Workbook、Worksheet、Cells一层层下去Unity开发者上手很快。这里特别提醒一个坑EPPlus从5.0版本开始底层协议从LGPL变成了Polyform Noncommercial也就是非商业场景免费、商业使用需要单独买授权。如果你的项目只是学习、做Demo或内部工具用5.x版本完全没问题如果是商业游戏或商业应用建议从EPPlus官网了解授权细节或者改用其他合规方案。我在实际项目里选择的是EPPlus 4.5.3.3版本这是最后一个可以无差别免费使用的版本功能上处理Excel 2007格式的读取已经完全够用。1.2 这个方案的整体流程拆解整个流程大致分成四段。第一段是数据准备在Excel里建立固定的工作表结构通常至少包含题干、选项A到D、正确答案、解析这几列。第二段是工程集成把EPPlus的DLL放进Unity项目的Plugins目录或者用NuGet安装后拷贝依赖。第三段是写读取代码用EPPlus打开.xlsx文件逐行遍历指定区域把单元格内容映射到自定义的Question类。第四段是运行时数据消费题目列表可以直接挂在MonoBehaviour上或者做成ScriptableObject存档再交给UI模块随机抽题。我见过不少人把这个过程想得很复杂实际拆开看就是“打开Excel - 读到DataTable - 转成对象列表”三步。EPPlus在其中承担的是xml解析和内存映射的脏活我们只需要关注数据长什么样、读出来以后怎么用。2. EPPlus的环境准备与基础读取写代码之前先把环境搭好。这里针对不同Unity版本给出可操作的方案。2.1 在Unity工程里安装EPPlus以Unity 2021或2022的默认配置为例最简单的方式是直接下载对应版本的DLL文件放到Assets/Plugins/EPPlus目录下。需要注意EPPlus依赖几个基础库如果运行时提示找不到Microsoft.Extensions等命名空间要一并把依赖的DLL拷贝进去。我用过的依赖项包括System.IO.Compression、System.IO.Compression.FileSystem、System.Security等具体清单以你下载的版本发布说明为准。如果你用的是Unity 2019.4 LTS以上版本也可以尝试通过NuGet包管理器把EPPlus装到工程目录然后用Unity的自定义程序集引用。这个方法的好处是依赖关系清晰缺点是操作步骤会多几步而且并非所有Unity版本都能直接兼容.NET Standard 2.1所以我对大多数读者的建议是直接拷贝DLL到Plugins目录简单直接出了问题也好排查。装完以后在脚本里写下using OfficeOpenXml;和using System.IO;然后试试这段最简单的读取代码using OfficeOpenXml; using UnityEngine; public class ExcelReaderTest : MonoBehaviour { void Start() { string path Application.streamingAssetsPath /QuestionBank.xlsx; using (FileStream fs new FileStream(path, FileMode.Open, FileAccess.Read)) { using (ExcelPackage package new ExcelPackage(fs)) { ExcelWorksheet sheet package.Workbook.Worksheets[题库]; int rowCount sheet.Dimension.End.Row; Debug.Log(总行数: rowCount); } } } }这段代码里最关键的是ExcelPackage这个入口类。EPPlus的一切都是从它开始的Workbook对应整个工作簿Worksheets[题库]按名字拿到工作表Dimension.End.Row可以直接拿到数据区域的最后一行索引。只要这段能跑通并输出“总行数”说明DLL和依赖都没有问题接下来就可以做真正的数据映射了。2.2 Excel文件放哪里最合适Unity读取外部文件有几个标准位置StreamingAssets是首选。因为Assets目录下只能放Unity可识别的资源而StreamingAssets目录里的文件会原样打包进最终版本无论是编辑器运行还是真机运行都能通过Application.streamingAssetsPath拼出完整路径。比如上面代码中的路径写法在PC编辑器上指向工程目录下的StreamingAssets文件夹在Android上会指向APK内部的一个特殊位置。如果用Resources目录存放Excel文件理论上也可以但Resources目录会对资源做压缩和序列化拿到的文件路径和原始路径不一定一致直接FileStream打开很容易报错。用AssetBundle加载Excel更是自找麻烦没有充分的理由不建议尝试。还要提一个跨平台细节Android上StreamingAssets区的文件是被封装在APK压缩包里的直接用FileStream打开会失败。标准做法是把文件先拷贝到Application.persistentDataPath再从这个可写目录打开。这个步骤在网络上也很多人提但真正踩过坑才会注意因为编辑器环境下一切正常一到Android真机就报“文件不存在”或“找不到路径”。#if UNITY_ANDROID string sourcePath Application.streamingAssetsPath /QuestionBank.xlsx; string targetPath Application.persistentDataPath /QuestionBank.xlsx; if (!File.Exists(targetPath)) { byte[] data File.ReadAllBytes(sourcePath); File.WriteAllBytes(targetPath, data); } path targetPath; #else path Application.streamingAssetsPath /QuestionBank.xlsx; #endif这段代码写进项目里以后至少能少踩一个安卓真机的暗坑。3. 题库数据结构设计与读取实现环境没问题了下面考虑数据模型。这一步做得不好后面读取代码就会越写越乱。3.1 Excel题库的推荐表结构我习惯把题库工作表的模板固定成下面的样子每一列代表一个字段第一行是表头从第二行开始是题目数据。列字段名说明A题号可以不填程序里按行号自动生成B题干题目正文支持中文、标点、换行C选项A文本内容D选项B文本内容E选项C文本内容F选项D文本内容G正确答案单字母A/B/C/D也可扩展到多选H解析答案解释可留空这里有几个设计取舍值得说一下。题号列我通常不依赖因为Excel里做插入删除操作时手工维护序号容易出乱子程序用行号减一作为题目索引更稳。正确答案列用“A/B/C/D”而不是文字本身是为了解析方便后面判断对错时只需要一次索引映射。解析列允许留空读取时要做空值保护不能直接ToString()拿空白字符串去占位。如果想支持多选题正确答案列可以写成“ABD”这种连续字母串程序读取后用Contains判断即可。如果想支持图片题可以额外加一列“图片路径”存相对于StreamingAssets的路径运行时用WWW或UnityWebRequest加载。表格结构不要设计得太复杂列越少策划填写的错误率越低。3.2 定义题目实体类在Unity工程里新建一个C#脚本内容如下[System.Serializable] public class QuestionData { public string question; public string[] options new string[4]; public string answer; public string explain; public int number; }字段命名越短越好方便序列化面板显示也方便后续在UI中直接绑定。options用数组而不是四个独立字段是为了让选项的渲染可以用一个循环搞定避免写四遍optionA_Text.text ...这种重复代码。如果题目数量不多也可以直接把这个类标记为[System.Serializable]然后挂在MonoBehaviour上在Inspector里预览数据。但如果题库很大比如上千道题字段全堆在Inspector里会导致编辑器卡顿建议保持纯数据类只在运行时使用。3.3 核心读取代码解析核心读取方法可以封装成一个工具类输入Excel文件路径输出List。下面是一份我实际调通了很久的参考实现public static ListQuestionData LoadQuestionsFromExcel(string excelPath) { ListQuestionData result new ListQuestionData(); if (!File.Exists(excelPath)) { Debug.LogError(题库文件不存在: excelPath); return result; } using (FileStream fs new FileStream(excelPath, FileMode.Open, FileAccess.Read)) using (ExcelPackage package new ExcelPackage(fs)) { ExcelWorksheet sheet package.Workbook.Worksheets[题库]; if (sheet null || sheet.Dimension null) { Debug.LogError(题库工作表为空或不存在); return result; } int rowCount sheet.Dimension.End.Row; for (int row 2; row rowCount; row) { string questionText sheet.Cells[row, 2].Text; if (string.IsNullOrEmpty(questionText)) continue; QuestionData q new QuestionData(); q.number row - 1; q.question questionText; q.options[0] GetCellTextOrEmpty(sheet, row, 3); q.options[1] GetCellTextOrEmpty(sheet, row, 4); q.options[2] GetCellTextOrEmpty(sheet, row, 5); q.options[3] GetCellTextOrEmpty(sheet, row, 6); q.answer sheet.Cells[row, 7].Text.Trim(); q.explain GetCellTextOrEmpty(sheet, row, 8); result.Add(q); } } return result; } private static string GetCellTextOrEmpty(ExcelWorksheet sheet, int row, int col) { return sheet.Cells[row, col].Text null ? : sheet.Cells[row, col].Text; }有几个细节要特别说明。单元格用Text属性而不是Value属性这是一个非常容易踩的坑。Value拿到的是底层的object可能是double、DateTime、string或者null直接ToString()格式不受控而.Text是EPPlus根据单元格显示格式处理后输出的字符串中文、数字、公式计算结果都能按Excel界面上看到的样式返回这对题库这种以显示文本为主的数据源来说是绝对正确的选择。跳过空行的逻辑写在循环开头防止Excel中间某一行被误删后后面一堆空行被读进来让题目序号错乱。如果表头不在第一行而是从第三行或更晚开始可以把起始行改成对应的数字这个逻辑用参数传入更灵活。3.4 数据校验与容错处理读取不算完还要做一层校验。我发现很多人卡在“程序里读了一堆空题目”或者“选项对不上”这种问题上源头往往就是没在读取时做检查。比如正确答案列如果填了“a”而不是“A”我们统一在读取时做Trim()和ToUpper()这样策划在Excel里随手输入的小写字母也能被正确识别。又比如选项里如果有公式生成的文本比如不知道这种写法Text属性也能正确拿到结果。还有设置单元格格式的情况错误答案列显示“A. 选项文本”还是纯“选项文本”这个规则要提前跟策划约定好程序里统一判断或统一剥离前缀避免混在一起。更稳妥的做法是在读取循环里加一道校验检查四个选项是否为空、题干是否为空、答案是否合法if (string.IsNullOrEmpty(q.question) || string.IsNullOrEmpty(q.options[0]) || string.IsNullOrEmpty(q.options[1]) || string.IsNullOrEmpty(q.options[2]) || string.IsNullOrEmpty(q.options[3]) || string.IsNullOrEmpty(q.answer)) { Debug.LogWarning(第 q.number 题存在空字段跳过该题); continue; }虽然题目多了以后任意跳过可能会让数量和Excel对不上但总比运行时拿空字段生成UI要好。排查时直接看Log里的行号比肉眼扫几百行Excel快得多。4. 踩坑实录与问题排查技巧这部分是跟EPPlus和Unity死磕之后印象最深的地方。我尽量写清楚每个问题是什么场景触发的以及解决方案为什么有效。4.1 编辑器能读打包后读不到文件症状是在Unity编辑器中运行一切正常一旦Build到Windows或Android程序提示找不到Excel文件。绝大多数情况下问题出在文件放置位置和打包路径上。StreamingAssets目录的文件虽然会被复制到最终包里但如果你用编辑器本地的绝对路径去读当然是找不到的。正确做法是永远用Application.streamingAssetsPath拼相对路径不要自己写死D:/xxx/QuestionBank.xlsx这种路径。Android上的处理方式就更多了前面已经提到要拷贝到persistentDataPath。这里再补一个细节Android下Application.streamingAssetsPath返回的是jar:file://...形式的URL直接用File.ReadAllBytes无法访问必须通过UnityWebRequest的file://协议或WWW来读取原始字节再在C#侧写文件。我就是因为忽略了这一步浪费了整整一晚上调试时间。4.2 中文乱码与编码问题EPPlus读取Excel本身返回的是Unicode字符串正常情况下不会出现中文乱码。如果你发现读出来的字符串显示成“锟斤拷”或问号请先检查控制台编码设置尤其是Windows环境下Unity的Log输出。不要急着把问题归结到EPPlus身上先建一个最简单的Debug.Log打印固定中文如果Log本身乱码说明是编辑器或控制台显示问题而不是数据问题。另一种相对少见的情况来自.xls格式和老版本Excel。EPPlus只支持.xlsx不支持.xls。如果你拿到的文件是.xls后缀先另存为.xlsx再读取。这个限制在官方文档里写得很清楚但确实有很多人第一次用就踩上去。4.3 线程问题与UI刷新如果你的读取逻辑放在异步线程或协程后台执行要注意Unity的API不能在非主线程调用。EPPlus的纯数据读取本身不依赖Unity API所以后台解析没问题但拿到结果后要回到主线程再赋值给UI对象否则Unity会抛出“illegal cross-thread call”之类的异常。稳妥的做法是先把读取结果存到一个临时变量然后在Update或协程里统一刷新。我实际遇到过一种奇怪的现象读取成功但UI列表显示不全刷新的Texture全是第一页的。排查后发现是异步线程还没跑完UI就开始渲染列表等于数据还没回来就画了第一帧。后来改成协程里等待任务完成再刷新问题就消失了。你要记住这个顺序先取数再刷新中途不要碰UI。4.4 加了DLL但编译报错如果你导入EPPlus后脚本报了一堆找不到命名空间的错先别急着换库版本。大多数情况下你的项目.NET版本设置太低了。在Player Settings里找到Api Compatibility Level如果选的是.NET 2.0换成.NET 4.x或.NET Standard 2.0就能解决。EPPlus依赖的许多类型比如FileStream异步方法、LINQ扩展都需要较新的运行时支持。还有一种情况是DLL本身体积过大导致打包时间明显变长。我的经验是如果只是做题库读取可以尝试用官方提供的EPPlus只读轻量模式或者按需裁剪DLL依赖。不过裁剪有风险和调试成本项目不赶时间的话不建议折腾。4.5 公式单元格读不出结果题库Excel里如果用了公式比如在某个单元格里写RIGHT(A1,3)这种提取函数EPPlus的Value属性拿到的可能是公式的缓存值或空值。上面我们提过用.Text属性的方案这个问题就不会太明显。但你还是要留意如果Excel文件是从某个在线表格工具或第三方应用导出生成的公式缓存可能根本没算出来.Text也会返回空字符串。遇到这种情况建议在Excel里全选数据、右键粘贴为数值再刷新保存通常能解决。还有一个特别隐蔽的问题Excel里单元格的数字如果被设置成“文本”格式读取时没问题但如果被设置成“常规”格式且内容是长数字串比如超过11位的IDExcel会显示成科学计数法.Text拿到的字符串就是“3.01411E12”这种形态而不是原始数字。处理方案是在Excel里把那一列统一设置成文本格式或者程序里判断是否含“E”再转换回普通数字字符串。小细节但真能让人抓狂。5. 项目扩展从Excel到运行时题目的完整闭环到这里核心读取能力已经具备。下面是把这个能力接进Unity实际项目里的两个常用方向。5.1 方案A运行时直接读取Excel适合题库量小、每次启动需要即时加载的场景。把读取到的List存在一个static类里其他UI脚本直接访问。优点是策划改完Excel放到StreamingAssets重新打包或直接替换文件就能看到效果很适合开发期和测试期快速迭代。缺点是运行时读Excel毕竟不是最快的方案题目上千时首次加载可能有几百毫秒的卡顿而且每次启动都解析一遍对低配手机不太友好。5.2 方案B编辑器转Json再运行时读取适合题库量大、对运行时性能有要求的场景。做法是写一个Editor脚本用EPPlus读取Excel把数据转换成Json文件输出到Resources或StreamingAssets运行时直接加载Json完全不依赖EPPlus。这个思路我非常推荐因为Excel只存在于开发期最终产物是更轻量的Json运行时没有解析Excel的开销也不需要在正式包里带着EPPlus这个不小的DLL。我把这个方案叫“编辑器抽样式转换”在Unity的菜单栏上增加一个“题库打包”按钮点一下就把Excel内容输出成一个QuestionBank.json控制台显示转换了几道题、有无空行警告。这样策划改了Excel后自己点一下按钮就能出包程序不需要每次介入效率非常可观。Json的格式可以设计成[ { number: 1, question: Unity是由哪家公司开发并维护的, options: [A点, B点, C点, D点], answer: A, explain: 这是一个基础概念题 } ]运行时用JsonUtility.FromJsonListQuestionData或者JsonConvert.DeserializeObject直接反序列化速度比逐行读Excel快一个数量级。这种方式也天然避开了版权层面的纠结EPPlus只在编辑器阶段出现最终包里不需要携带它的DLL商业发布时少一个授权顾虑。5.3 配套的编辑器转换脚本骨架下面这个脚本我建议放在Editor目录下属于开发工具不会打进运行时包#if UNITY_EDITOR using UnityEditor; using UnityEngine; using System.Collections.Generic; using System.IO; using OfficeOpenXml; public class QuestionBankTool { [MenuItem(Tools/题库打包)] public static void ExportQuestionBank() { string excelPath Application.dataPath /../StreamingAssets/QuestionBank.xlsx; ListQuestionData list ExcelLoader.LoadQuestionsFromExcel(excelPath); string json JsonUtility.ToJson(new QuestionList { list list }); File.WriteAllText(Application.streamingAssetsPath /QuestionBank.json, json); AssetDatabase.Refresh(); EditorUtility.DisplayDialog(完成, 题库生成成功共 list.Count 题, 确定); } } [System.Serializable] public class QuestionList { public ListQuestionData list; } #endif注意JsonUtility.ToJson的参数不能直接传List需要一个包装类这是Unity序列化工具的老规矩。如果不喜欢这种包装方式可以换用Newtonsoft.Json或System.Text.Json但Unity内置的JsonUtility足够覆盖简单场景少引一个依赖就少一个坑。5.4 运行时UI怎么接这套题库拿到的列表最终要交给UI显示。我的做法是建立一个简单的QuestionDisplayer组件持有ListQuestionData questions维护一个currentIndex每次调用ShowQuestion(index)时把题干、选项文本、正确答案依次填充到Text和Button上。这个组件不关心数据从哪来只负责显示Io接口上非常干净。在初始化时我的做法是ListQuestionData questions; #if !UNITY_EDITOR questions JsonLoader.LoadFromJson(QuestionBank.json); #else string excelPath Application.streamingAssetsPath /QuestionBank.xlsx; questions ExcelLoader.LoadQuestionsFromExcel(excelPath); #endif这样开发期直接读Excel发布时读Json一条编译开关就能切换我自己用下来非常顺手。当然如果你已经决定一直走运行时读Excel的路子也可以跳过Json这一层全篇只用一种加载方式避免两套逻辑增加心智负担。6. 一些经验和性能优化的心得最后分享几个零散但实用的心得。第一个是不要小看Excel文件的体积。一个一百题的题库Excel文件可能只有几十KB但EPPlus在解析时会先把整个工作簿载入内存如果你在手机上读一个几MB的Excel瞬时内存峰值不容小觑。如果题库继续膨胀建议做分表处理一次只读一个子工作表避免一次性全量加载。第二个心得是正确答案的判断不一定要用字符串相等。把选项做成一个索引然后正确答案那一列存索引而不是字母可以减少一层转换。比如0表示选项A、1表示选项B但这会降低Excel的可读性策划不一定会愿意配合。如果你能说服内容团队用“A/B/C/D”习惯那字符串方案其实也够快。第三个心得是关于空行过滤的再思考。我上面的代码用continue跳过空行但如果你需要严格核对Excel里的题号和程序里的序号完全一致建议在表头直接用题号列读取时把题号列里的数字赋值给number字段而不是依赖行号减一。这样不管Excel中间怎么插入、删除、排序题号跟数据始终绑定。第四个心得是保留一份原始Excel备份。每次在Unity里读取后不要原地覆盖原始文件可以把文件拷贝到一个备份目录。我有一次因为直接在Unity里改了StreamingAssets下的Excel文件结果Excel进程没退出文件被占用读取时报“文件正在被另一进程使用”排查了老半天。后来所有编辑操作都改成先复制到临时目录再处理这类问题再也没出现过。6.1 关于版本和依赖的最终建议如果你用的是Unity 2020 LTS之前的老版本建议选择EPPlus 4.5.3.3或更早的4.x版。如果你用的是Unity 2021 LTS以上版本并且项目可以接受商业授权的限制5.x版本能用很多新API性能和稳定得也好。但不管哪个版本都要把DLL放到Plugins下使用前先在空工程里跑通基础读取再接业务逻辑这样万一出错定位成本会低很多。文件路径的兼容性也要提前想清楚。StreamingAssets在Windows、Mac、Android、iOS上各有各的坑。Windows下直接使用绝对路径Mac下注意大小写Android要解压iOS虽然不需要解压但路径要拼对。所有这些问题都归结为一句话写出路径时永远用Application.streamingAssetsPath打底不要在代码里写死盘符或斜杠方向。6.2 后续功能扩展的几个方向题库读取做好以后往上叠加功能是非常顺手的。比如你可以做随机抽题用Random从List里选N道不重复题目每次放进一个子列表保证一局不重复。你也可以做难度过滤在Excel里增加一列“难度”读取时按难度分组运行时根据玩家进度取对应区间的题目。错题本也可以做记录答错的题目编号下次优先抽取。如果题目数量特别大超过几千道建议在读取时直接排序或压缩。比如用Linq对题目按难度字段分组或者把常用数据缓存成ScriptableObject在内存中持有避免每次切换场景都要重新解析。这些都是在“读取”这个基础能力之上顺理成章的长尾需求。我个人在实际操作中的体会是先不要急着上完整框架把Excel表结构定好、读取代码写顺、校验和空行处理做强这套基础做扎实了后面的业务层怎么写都不会太难。EPPlus对大多数Unity项目来说就像一个万能钥匙打开Excel这扇门之后剩下的玩法完全取决于你的想象力和工程质量。希望这篇经验能帮你少走几步弯路你的题库项目可以因此更从容地开始。