Unity 开发答题系统：用 EPPlus 读取 Excel 搭建可维护题库

做答题类项目最烦的不是写逻辑，不是调UI，而是改题目。去年我做一个模拟测验Demo，策划同学每天发来一版改动，Json文件复制粘贴、转义、查漏，光整理数据就浪费了一下午。后来我换了思路，直接在Unity里用EPPlus读取Excel生成题库，策划改完表格发给我，我扔进StreamingAssets目录就能跑，再也不用手动维护Json结构。这篇文章就记录一下这套“Excel出题”的完整做法，包括环境配置、表格设计、代码实现、打包期避坑，以及我踩过的几个典型坑，希望给同样在Unity里做答题、测验、刷题类功能的同学一个可以直接抄作业的参考。

这套方案适合谁？如果你正在做课程Demo、内部工具、答题小游戏，或者纯粹想给项目加一个可维护的题库系统，那EPPlus是性价比很高的选择。它不需要你把Excel转成CSV，也不用引入一堆运行时插件，直接在C#里以流的形式读取.xlsx原始内容，解析成自定义对象，后续不管是接UGUI还是接UI Toolkit都方便。下面我按实际开发顺序把整个流程拆开讲。

1. 项目概述与整体思路

1.1 核心需求解析

先说清楚这个题库系统到底要解决什么。你做答题类功能，核心数据无非是题干、选项、答案、解析这四类，外加题型和分值这些辅助字段。很多同学习惯把这些数据写成Json或ScriptableObject，但实际维护起来很痛苦：改一个错别字要重新找到对应节点，加一道题要数半天逗号，非技术人员更是完全不敢碰。

用Excel就不一样。每一行是一道题，每一列是一种属性，策划或者运营同学打开表格就能编辑，根本不用碰代码。EPPlus做的就是让Unity程序在运行时直接读取这个Excel文件，把每一行数据映射成代码里的一个题目对象。这也是整套方案最核心的闭环：表格维护数据，代码只负责解析和展示。

另外一个容易被忽略的需求是“题型可变”。不是所有题目都是四选一，还得有判断题、多选题，甚至以后可能加填空题。所以题目对象在设计之初就得留好扩展余地，不能写死成单选结构。我下面给的方案里，题型用枚举区分，选项和答案都用字符串数组承载，就是为了让表格加列、改列时，代码改动成本最低。

1.2 技术选型：为什么选EPPlus而不是其他方案

Unity读取Excel有好几条路可选，我建议你根据自己的场景先看清楚再决定。纯商业项目可以用专门的表格导出工具，把Excel转成二进制、Json甚至代码结构自动生成，但这类工具集成成本高，对小团队和独立开发者来说有些重。CSV方案最轻量，但格式限制多，多选题答案带逗号就麻烦，单元格换行更是灾难。Json方案结构灵活，但正如开头说的，维护体验差。

EPPlus在这中间是个很好的平衡点。它是一套.NET框架下读取/写入Excel文件的开源库，你只需要把一个DLL放进Unity工程，写几行代码就能拿到工作表里的行列数据。它还能保留单元格公式、样式这些信息，不过我们做题库用不到这么复杂的能力。

有一点必须提醒：EPPlus从5.x版本开始引入了商业授权判断，如果你只是做学习Demo、课程设计或者公司内部工具，建议直接用4.5.3.3这个版本，这也是网上能找到的最后一个完全免费版本。如果是商用项目，请自己去确认5.x的授权条款，别稀里糊涂埋了雷。后文的所有示例代码我都默认用的是4.5.3.3的API，兼容性最稳。

1.3 功能范围界定

我在这套实现里圈定的功能范围是：运行时从Excel加载题目，支持单选、多选、判断三种题型，支持随机出题、答案比对、答题进度和分数统计，最后能一键重新开始。界面部分就用最简单的UGUI做，按钮和文本全靠代码引用，不写复杂框架。这样整体代码量控制在一个游戏管理的控制器加一个读取工具类加两个数据类左右，你看完完全能自己复现。

如果你后面想扩展，比如加倒计时、每题限时、错题本、记录历史成绩，这套基础结构都留了口子。题目对象加字段，表格加列，加载方法顺手把这个字段读出来就行。

2. 环境准备与Excel模板设计

2.1 Unity工程配置与EPPlus导入

先说环境配置。打开Unity工程后，先把Player Settings里的Api Compatibility Level改为.NET Framework（旧版本叫.NET 4.x）。EPPlus依赖了不少.NET标准库下的功能，如果保持默认的.NET Standard 2.0，编译阶段就会冒出一堆类型找不到的错误。这是新手最容易卡住的第一关。

接着把下载好的EPPlus dll拖进Assets目录，建议单独建一个Plugins文件夹放它。Unity 2019及以上版本默认不会对Plugins下的DLL做额外处理，直接引用命名空间就能用。有一点要注意：如果你以后切换到IL2CPP打包，EPPlus内部用了反射，可能会被代码裁剪掉一部分功能，所以这套方案现阶段建议用Mono打包做测试，或者干脆只在编辑器模式下使用运行时加载，打包前把题库固化成文本缓存。我后面第五部分会详细说这个坑。

2.2 Excel表格结构设计

表格怎么设计直接决定代码怎么写。我建议第一行固定为表头，程序从第二行开始遍历数据。下表是我在这套方案里用的列结构，你可以按需增删。

列索引	列名	含义	示例
A	Id	题目编号	1001
B	Type	题型	Single / Multiple / Judge
C	Title	题干	以下哪个选项是Unity中的物理引擎？
D	OptionA	选项A	PhysX
E	OptionB	选项B	Box2D
F	OptionC	选项C	Havok
G	OptionD	选项D	Bullet
H	Answer	答案	A
I	Analysis	解析	Unity默认内置PhysX物理引擎

判断题比较特殊，选项A和选项B固定填“正确”“错误”，答案填A或B就行。多选题答案直接填选项字母，比如“ABD”，中间不要加逗号，这样程序拿到字符串后直接拆字符就能逐个比较。这里有个小细节：Excel的单元格默认可能会把ABCD当成文本或公式，你最好把选项列和答案列的单元格格式都手动设为“文本”，避免某些时候出现科学计数法或自动转换的问题。

2.3 数据规范与校验规则

表格写多了你就知道，出题内容可以乱，但表头不能乱，字段格式更不能乱。我在这套方案里定了几条硬性规则，加载代码也会逐条校验，不合规的行直接跳过并打印警告，不会让整个读取过程崩溃。

第一条，题型列只认三种枚举值：Single、Multiple、Judge，大小写不敏感，代码内部统一转成大写后再匹配。第二条，选项列如果为空，程序会把该选项视为不存在，后续判题会遇到“答案引用了空选项”的异常，所以最好保证选项数量完整。第三条，答案列是判断题时只能填A或B，单选填一个字母，多选填一个或多个字母，且所有字母必须真实存在于选项列中。第四条，题干、答案、解析里不要用特殊换行符，单元格内的换行在部分版本里会被解析成正则匹配不到的空字符，导致结果对不上。

为了降低人工填写的失误概率，我强烈建议在代码加载完成后做一个control面板式的日志输出：把每一道题的核心字段打出来扫一眼，尤其关注解析后的答案串和题目数。亲眼看到数据进了内存，比什么校验逻辑都管用。

3. 核心代码实现：从Excel到题库对象

3.1 题库数据结构设计

在写读取逻辑之前，先把数据结构定下来。我设计了一个QuestionType枚举、一个Question类和一个QuestionBank类，尽量保持纯粹的数据模型，不掺任何Unity引擎功能，这样后面做单元测试或者移植到其他框架都方便。

public enum QuestionType { Single, Multiple, Judge }

[System.Serializable] public class Question { public int Id; public QuestionType Type; public string Title; public List<string> Options = new List<string>(); public string Answer; public string Analysis; public bool IsCorrect(string playerAnswer) { if (string.IsNullOrEmpty(playerAnswer)) return false; string a = Answer.Trim().ToUpper(); string p = playerAnswer.Trim().ToUpper(); if (Type == QuestionType.Multiple) { return SortAnswer(a) == SortAnswer(p); } return a == p; } private string SortAnswer(string source) { char[] chars = source.ToCharArray(); System.Array.Sort(chars); return new string(chars); } }

这里有个关键点：多选题判分不能直接做字符串相等，因为玩家可能以不同顺序点选选项，答案是“ABD”而玩家选了“ADB”。我的做法是把两边都转成字符数组排序后再比较，只要选的字母集合相同就算对。这个细节看起来小，实际答题系统里非常容易漏，漏了就出现“明明选对了却判错”的玄学问题。

QuestionBank就非常简单，只包装一个List 并暴露几个便捷方法，比如根据Id查找题目、返回题目总数等，不写复杂逻辑。

3.2 Excel读取工具类

下面这段是整套方案的主干代码，作用是把指定路径的.xlsx文件读取出来，逐行解析成Question，装进QuestionBank返回。我实际实现时把它放到了一个静态工具类里，方便任何场景直接调用。

using System.Collections.Generic; using System.IO; using OfficeOpenXml; using UnityEngine; public static class QuestionLoader { public static QuestionBank LoadFromExcel(string excelPath) { QuestionBank bank = new QuestionBank(); if (!File.Exists(excelPath)) { Debug.LogWarning("题库文件不存在: " + excelPath); return bank; } using (FileStream fs = new FileStream(excelPath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite)) using (ExcelPackage package = new ExcelPackage(fs)) { ExcelWorksheet sheet = package.Workbook.Worksheets[0]; int rowCount = sheet.Dimension.End.Row; int colCount = sheet.Dimension.End.Column; for (int row = 2; row <= rowCount; row++) { if (IsRowEmpty(sheet, row, colCount)) continue; Question q = new Question(); q.Id = GetIntValue(sheet, row, 1); string typeText = GetStringValue(sheet, row, 2).ToUpper(); q.Type = ResolveType(typeText); q.Title = GetStringValue(sheet, row, 3); for (int col = 4; col <= 7; col++) { string option = GetStringValue(sheet, row, col); if (!string.IsNullOrEmpty(option)) q.Options.Add(option); } q.Answer = GetStringValue(sheet, row, 8).ToUpper(); q.Analysis = GetStringValue(sheet, row, 9); if (Validate(q)) { bank.Questions.Add(q); } else { Debug.LogWarning($"第{row}行题目校验失败，已跳过。题干: {q.Title}"); } } } return bank; } private static string GetStringValue(ExcelWorksheet sheet, int row, int col) { object value = sheet.Cells[row, col].Value; return value == null ? "" : value.ToString().Trim(); } private static int GetIntValue(ExcelWorksheet sheet, int row, int col) { string s = GetStringValue(sheet, row, col); int result = 0; int.TryParse(s, out result); return result; } private static bool IsRowEmpty(ExcelWorksheet sheet, int row, int colCount) { for (int col = 1; col <= colCount; col++) { if (!string.IsNullOrEmpty(GetStringValue(sheet, row, col))) return false; } return true; } private static QuestionType ResolveType(string typeText) { if (typeText.Contains("MULTI")) return QuestionType.Multiple; if (typeText.Contains("JUDGE")) return QuestionType.Judge; return QuestionType.Single; } private static bool Validate(Question q) { if (string.IsNullOrEmpty(q.Title)) return false; if (string.IsNullOrEmpty(q.Answer)) return false; if (q.Options.Count == 0) return false; if (q.Type == QuestionType.Judge && q.Options.Count < 2) return false; return true; } }

这里有一个使用细节值得展开：读取单元格时我用的是Value而不是Text。Text属性是EPPlus经过格式化后给用户展示的文本，会做日期换算、数字格式化等处理；Value返回的是单元格的原始值，更干净。做程序设计时我建议优先用Value再自己ToString，避免Excel里一个普通数字“2024”被格式化成“2,024”之类的意外。

还有开头提到的FileShare.ReadWrite参数。加上它之后，即使Excel文件正被WPS或Office软件的进程占用着，程序也能以共享模式打开读取，不会因为文件被锁定而报错。这个参数建议保留，别图省事去掉。

3.3 数据解析与边界处理

解析过程中最常见的边界情况是Excel末尾有很多“看着是空行但实际上有格式残留”的行。所以我在循环里加了一个IsRowEmpty方法，判断一整行是否全为空，是就跳过。这样做的好处是：策划同学为了对齐美观在表格底部多发了几行空白占位，程序不会误识别成一道空题目。

另一个边界情况是选项数量不足。比如某道判断题只填了两个选项，而代码里默认取四列选项，解析后Options.Count是2，Validate方法会直接拦截。对于多选题，如果策划漏填了C或D选项，加载日志里就会把这道题标记成“校验失败”，方便你立刻倒回去修表格。

再唠叨一句字段解析顺序。我在Example代码里把多选题答案做成了“ABD”这种连续字符串，所以读取时不需要额外解析，直接用就行。如果你希望Excel里更直观，也可以用“A,B,D”这种带分隔符的写法，那你就要在GetStringValue之后再做一次Split操作，并过滤掉空串。你自己选一种，两种都行，但务必在表格规范里写清楚，让填表的人有据可依。

4. 运行时加载与答题流程

4.1 文件位置与加载路径方案

Excel文件放在哪里，直接决定了读取代码长什么样。Unity工程里有三种常见位置：Assets/Resources、Assets/StreamingAssets、以及任意自定义路径。Resources目录的问题在于.xlsx不是Unity原生可识别的资源格式，LoadAsset加载不了，还得改扩展名避过检查，非常别扭。StreamingAssets是正统做法：文件会原样打进安装包，代码运行时可以拼出绝对路径去读，既支持编辑器环境也支持真机环境。

以StreamingAssets为例，编辑器和真机拼路径的方式略有不同。编辑器下是Application.dataPath + "/StreamingAssets/题库.xlsx"，真机上要用Application.streamingAssetsPath拼同样的文件名。不过安卓平台上StreamingAssets其实在APK压缩包内部，直接用FileStream打开会失败，正确姿势是先用UnityWebRequest把文件读成byte[]，再手动包一层MemoryStream交给ExcelPackage。我建议把这段加载逻辑单独封装成一个方法，让它返回MemoryStream，上层不用关心文件是本地还是压缩包内部。

using System.Collections; using System.IO; using UnityEngine; using UnityEngine.Networking; public static class ExcelFileReader { public static IEnumerator LoadStreamingAssetBytes(string fileName, System.Action<byte[]> onSuccess, System.Action<string> onError) { string path = Path.Combine(Application.streamingAssetsPath, fileName); using (UnityWebRequest request = UnityWebRequest.Get(path)) { yield return request.SendWebRequest(); if (request.result == UnityWebRequest.Result.Success) { onSuccess?.Invoke(request.downloadHandler.data); } else { onError?.Invoke(request.error); } } } }

拿到byte[]之后，直接把QuestionLoader的入口改成接收Stream或者byte[]，不要让它自己猜路径。这样运行时和编辑器加载逻辑完全统一：编辑器测试也能走StreamingAssets路径，提前暴露打包后的路径问题。

4.2 答题流程与核心控制逻辑

读取Excel只是第一步，真正让题库转起来的是GameManager。它负责加载题目、洗牌、控制当前题号、接收玩家答案、判断对错、累计分数。我下面给一个精简但完整的实现，方便你直接套到自己的场景里。

using System.Collections; using System.Collections.Generic; using UnityEngine; public class GameManager : MonoBehaviour { public static GameManager Instance; [Header("UI引用")] public TextAssetText titleText; // 按你的UI组件替换 public UnityEngine.UI.Text titleUI; public UnityEngine.UI.Text optionsUI; public UnityEngine.UI.Text resultUI; public UnityEngine.UI.Text scoreUI; private List<Question> questions = new List<Question>(); private int currentIndex = 0; private int score = 0; private Question currentQuestion; private void Awake() { Instance = this; } private IEnumerator Start() { yield return StartCoroutine(ExcelFileReader.LoadStreamingAssetBytes("QuestionBank.xlsx", bytes => { using (MemoryStream ms = new MemoryStream(bytes)) using (ExcelPackage package = new ExcelPackage(ms)) { // 这里复用QuestionLoader按Stream解析的逻辑 } }, error => Debug.LogError(error))); } }

核心的状态流我建议拆成三个函数：StartRound()负责从题库里拿一道题并刷新UI；OnSubmitAnswer(string playerAnswer)负责判题并登记分数；NextQuestion()负责推进题号并检查是否结束。这样逻辑边界清楚，以后加倒计时或者加错题本都方便插入。

洗牌逻辑用Fisher-Yates就够了，遍历数组每次随机交换。真没必要引第三方随机工具类。要注意的是：重置游戏时必须重置currentIndex和score，否则玩家点了一次重新开始，题目序号还接着上次跑，分数也越加越离谱。

4.3 UI交互与答案比对实现

答题界面的UI部分用最简单的UGUI就好：一个Text显示题干，一个Text显示四个选项，一个InputField或一组Toggle接收答案，一个Button提交判断。我实际做的时候没有给每题单独建GameObject，而是复用一个模板动态刷新文本，这样表格里加再多的题都不需要改UI。

单选和判断可以直接用InputField输入“A”“B”这类字符串，拿到的值就是玩家答案。多选题如果UI用ToggleList，提交时把你勾选的那几个字母拼成一个字符串，再交给Question.IsCorrect比对。这里有一个体验层面的小建议：提交按钮的点击事件里区分“判题”和“下一题”两种状态，第一次点击显示解析和结果，第二次点击才跳下一题，不然玩家连题目都看不清就闪过去了。

比分统计上，我做的是每道题答对得10分，单选和多选都是。如果你想按难度加权，在Excel里增加一个Score列，Question类加一个Score字段，Parse时读进来，GameManager累加时直接用这个字段就行。流程代码不需要改，只改得分来源。

5. 常见问题与排查实录

5.1 编译报错与授权问题

先处理最多人问的编译问题。如果你把EPPlus dll放进来后，脚本报“找不到OfficeOpenXml命名空间”，99%是Api Compatibility Level设置没改。你在Player Settings里把Scripting Runtime Version和Api Compatibility Level都调到.NET 4.x/ .NET Framework，然后重启编辑器，问题基本消失。

还有一类集中在打包阶段：报错里带“LicenseContext”字样。EPPlus 5.x以上会在没有设置授权上下文时抛异常，最简单的解决方法是回到4.5.3.3版本。如果因为某些功能必须用5.x，那就在程序初始化时设置：

// 这部分只在EPPlus 5.x及以上需要 OfficeOpenXml.ExcelPackage.LicenseContext = OfficeOpenXml.LicenseContext.NonCommercial;

务必自行确认授权条款，别只看代码能跑就上线。

5.2 路径读取失败与中文乱码

很多同学第一次做流读取时发现编辑器下没问题，打包后读不到文件。原因是我前面说的安卓StreamingAssets在包内，不能直接用FileStream。判断诀窍很简单：如果Application.streamingAssetsPath以“jar:file:///”开头，就别用FileStream，改走UnityWebRequest。iOS上StreamingAssets虽然在应用沙盒里，路径处理也可能有差异，统一用UnityWebRequest读byte[]是最大公约数。

中文乱码的锅倒是很少扣在EPPlus头上。xlsx内部本质是UTF-8存储的XML，EPPlus解析出的字符串天然支持中文。如果你看到读取后全是问号，先检查Excel文件是否真的保存成xlsx而不是另存成的CSV，再检查有没有在读取后调用Encoding.Default转码这类多余操作。转码这个动作不是必须的，很多乱码反而是因为强行转成了系统ANSI编码。

5.3 题目数据对不上与判题错误

这类问题最隐蔽。举例：题目答案是“A”，玩家选“A”，但判题返回false。排查思路从两个点下手：Excel里答案列是不是包含不可见字符，比如全角空格；判断题答案如果填了“正确”而不是“A”，程序自然匹配不上。我在Question类的IsCorrect里全部做Trim和ToUpper，就是为了把这种不可见字符和大小写问题消掉。多选判错则多半是没做排序，参考3.1节的方法就能解决。

另外一个容易踩的是“解析失败但日志不显示”。Validate方法里我用了Debug.LogWarning，如果Import时脚本挂在场景中但GameObject被隐藏，或者日志级别被过滤，很容易漏网。建议在编辑器下打开Console，把所有Log级别显示出来，加载完成后再扫一遍警告条数。

5.4 性能优化与项目规模预估

EPPlus读取一张5000题、9列的表格，在PC上耗时大概在几百毫秒级别，放在加载界面完全能接受。但如果表格膨胀到几万行，或者你的游戏目标平台是低端手机，就要考虑两个优化方向。

第一个方向是编辑器缓存：在编辑器下读取一遍Excel，把解析好的QuestionBank序列化成Json或二进制asset，运行时不走EPPlus，直接加载缓存文件。第二个方向是按需读取：把题库拆成多个Excel文件，一关一个，进入关卡时只加载当前文件。这两种方案我都试过，对于“简单题库”的需求来说，第一种最实用，改动成本低；第二种适合超大规模题库，但对文件组织和命名规范要求更高。

如果你只是做课程作业或者开发期Demo，我最诚实的建议是：先别优化。几千题的加载耗时给玩家一个加载转圈就掩盖掉了，优化工作等真到了性能瓶颈再动手不迟。

最后分享两个小习惯

做成这套东西之后，我发现至少有两点值得坚持。第一，每次改完Excel后，打开编辑器跑一遍加载流程，看Console里有没有警告，不要等到打包才验证数据，否则你会发现错别字和错答案在真机上出现的概率远高于编辑器里。第二，Excel里所有表头和规范说明单独放一个隐藏Sheet，别跟题目混在一起，并且把这个隐藏Sheet锁死，防止有人误删列导致整个文件结构错乱。

还有个小技巧：如果你跟我一样经常需要在Excel里反复调整题目，可以在加载代码里加一个快捷键，比如按下某个键就重新加载一次题库，省去反复重启游戏的麻烦。我是绑定在F5上的，测试的时候非常舒服，改完表格回来按一下就是新题目，工作效率能明显提升一个档次。

最后再多说一句：这套方案的代码结构并不复杂，但它帮我省下了大量重复劳动。希望这篇记录也能让准备做类似功能的你少走几步弯路。