做管理后台的兄弟应该都遇到过这种需求运营那边拿着Excel模板来要数据但每次交上来的表都五花八门。性别栏能填出男/女/汉子/小姐姐/保密部门栏有的写技术部有的写技开有的写研发中心。整理这些数据比做功能还累。后来我干脆在模板下载这步动手生成Excel时就顺手把下拉框埋进去填表的人只能在允许的选项里选乱填的情况基本就绝迹了。这篇东西就把SpringBoot里实现带下拉框的Excel模板下载完整讲一遍包含EasyExcel的玩法、数据量大时的POI进阶玩法以及一堆我在生产环境里踩过的坑。适合做后端开发、正在搞导入导出模块或者被业务方自由发挥折磨过的兄弟。1. 模板下载背后藏着一个数据治理问题1.1 没有约束的Excel等于没有验收标准很多人觉得模板下载就是把表头打出来、让用户自己填不就这么简单吗真不是。你的表头写得再清楚也拦不住用户手滑。业务方拿到一个空模板面对性别这一列他脑子里想到的可不只是男和女还可能填不男不女保密随便。这时候数据回到你手里你后端怎么校验枚举判断还好说如果是部门、城市、项目编码这种半开放的数据你根本枚举不完。最终结果就是脏数据入库你还要写一堆清洗逻辑去兜底。所以模板下载这件事本质不是给用户一张空白表而是在用户填数据之前就把格式的边界划清楚。下拉框就是Excel里的数据验证Data Validation它能在单元格层面限制用户只能输入某几个选项。模板里有了这层约束用户填错的门槛就大大提高了——不是不能填而是他想填错Excel会直接弹窗拒绝。1.2 下拉框的本质Excel数据验证这个话题值得说透一点。你在Excel里点的下拉箭头底层其实是数据验证规则。Excel的数据验证可以干很多事不只是下拉限制整数范围比如年龄1-120限制日期范围限制文本长度序列Sequence就是下拉框也就是本文要用的自定义公式验证级联下拉就在这个范畴数据验证有两个关键要素验证条件Constraint和作用区域CellRangeAddressList。验证条件决定允许填什么作用区域决定哪些单元格要被约束。你把这两个要素组合好再附加一个错误提示框用户填了违规值Excel就会跳出一句请输入下拉列表中的内容之类的劝退文案。1.3 本文要交付的三种能力我会把实现拆成三个层次来讲静态下拉性别、状态这类固定枚举写死几行代码就搞定。动态下拉部门、城市这种存在数据库里的选项从后端查出来再塞进模板里。大选项集下拉下拉选项特别多、或者选项字符串特别长的时候直接用序列方案会踩到Excel的255字符限制这时候要用隐藏Sheet引用的玩法。每一层都会给可运行的代码和踩坑提示保证你直接抄作业能跑通。2. 技术选型为什么我最终选了EasyExcel 自定义Handler2.1 EasyExcel 与 Apache POI 的定位差异SpringBoot里做Excel导出绕不开两个选择阿里开源的EasyExcel 和 Apache POI。POI是Excel操作的底层标准库几乎所有Java操作Excel的开源项目都基于它。它给你的是一套完整的Workbook、Sheet、Row、Cell对象模型你想做什么都行但代价是代码量大、心智负担重。写一个带样式的表头加几列数据随便几十行代码起步。EasyExcel是阿里在POI之上封装的库主打注解式导出导入大部分场景下你只需要在实体类上加几个注解就能把表头和数据摆好。它本身并不直接提供给单元格添加下拉框的API但提供了WriteHandler钩子你可以在它写Sheet的各个阶段插入自定义逻辑。两者的关系你可以理解成POI是给你一堆乐高零件EasyExcel是给了你一套搭积木的图纸但图纸上没画的部分你还是得自己拿POI的零件去补。2.2 模板下载场景的关键取舍具体到模板下载下拉框这个场景我实际对比过维度EasyExcelApache POI上手成本低注解几行代码高对象模型上手有门槛表头/样式注解搞定省事每列都要手动建CellStyle下拉框支持无内置API需写Handler原生支持DataValidation复杂数据验证需要Hack但够用完全可控内存表现流式写优秀需要开SXSSF才能流式排查问题报错信息相对抽象报错直接可控性强我的建议是如果项目里本身就有大量导入导出需求比如每天要导订单、导报表那统一用EasyExcel维护成本低。如果只是偶尔做一次带复杂数据验证的模板下载直接用POI撸一套也行。但如果你想兼顾开发效率和功能完整度最佳组合其实是EasyExcel 自定义WriteHandler。这样表头和数据部分交给EasyExcel注解搞定下拉框这种特殊需求自己写Handler注入两边都不吃亏。2.3 依赖配置与版本兼容说明我用的是EasyExcel 3.3.4这个版本相对稳定对SpringBoot 2.x系列很友好。dependency groupIdcom.alibaba/groupId artifactIdeasyexcel/artifactId version3.3.4/version /dependency注意一点EasyExcel 3.x内置了POI依赖如果你的项目里还有其他组件也在用POI比如POI-TL做Word导出、自研报表模块一定要留意版本冲突。典型症状是运行时抛NoSuchMethodError因为EasyExcel自带的POI版本和你其他模块的POI版本不一致。解决办法就是用Maven的exclusion把EasyExcel自带的POI排除掉统一引入一个版本。dependency groupIdcom.alibaba/groupId artifactIdeasyexcel/artifactId version3.3.4/version exclusions exclusion groupIdorg.apache.poi/groupId artifactIdpoi/artifactId /exclusion exclusion groupIdorg.apache.poi/groupId artifactIdpoi-ooxml/artifactId /exclusion /exclusions /dependency如果项目是SpringBoot 3.x更要注意——SpringBoot 3从javax迁移到了jakarta命名空间EasyExcel低版本和SpringBoot 3的Servlet体系会有兼容问题。实测下来3.3.4及以上相对稳妥再老一点的版本建议直接升级别在依赖上省事。3. 核心实现向模板中注入下拉框3.1 从生成模板到写入约束的整体流程先理一下EasyExcel写模板的流程你才知道在哪个环节下手。EasyExcel执行写操作时大致会经历读取实体类注解信息、创建Workbook、创建Sheet、创建表头行、写数据行、关闭流。我们要插入下拉框最合适的时机就是Sheet创建完成之后、表头还没写或者还没写完的时候。EasyExcel预留了一个接口叫SheetWriteHandler里面有几个回调方法其中最核心的是afterSheetCreate。这个方法在Sheet创建完成后被调用此时你能拿到WriteWorkbookHolder和WriteSheetHolder。通过WriteSheetHolder.getSheet()能拿到当前写的Sheet对象通过WriteWorkbookHolder.getWorkbook()能拿到整个Workbook。拿到Sheet之后就可以用POI原生的数据验证API来添加下拉框了。这里有个反直觉的点你以为要让EasyExcel支持下拉框其实不是。下拉框本身就是POI的能力EasyExcel只是给了你一个合适的时间点让你能在这个时间点去调用POI的API。理解这一点后面看代码就会很通透。3.2 自定义SheetWriteHandler实现思路拆解我先给你看一个标准的SheetWriteHandler实现骨架它接收一个MapInteger, String[]Key是列索引Value是这一列的下拉选项。import com.alibaba.excel.write.handler.SheetWriteHandler; import com.alibaba.excel.write.metadata.holder.WriteSheetHolder; import com.alibaba.excel.write.metadata.holder.WriteWorkbookHolder; import org.apache.poi.ss.usermodel.DataValidation; import org.apache.poi.ss.usermodel.DataValidationConstraint; import org.apache.poi.ss.usermodel.DataValidationHelper; import org.apache.poi.ss.usermodel.Sheet; import org.apache.poi.ss.util.CellRangeAddressList; import java.util.Map; public class DropDownWriteHandler implements SheetWriteHandler { // 下拉列索引 - 下拉选项数组 private final MapInteger, String[] dropDownMap; // 下拉框作用的最大行数从数据行开始算 private static final int MAX_ROW 10000; public DropDownWriteHandler(MapInteger, String[] dropDownMap) { this.dropDownMap dropDownMap; } Override public void afterSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) { Sheet sheet writeSheetHolder.getSheet(); DataValidationHelper helper sheet.getDataValidationHelper(); dropDownMap.forEach((colIndex, values) - { if (values null || values.length 0) { return; } // 作用区域第1行开始0是表头到MAX_ROW行当前列 CellRangeAddressList rangeList new CellRangeAddressList(1, MAX_ROW, colIndex, colIndex); // 创建序列约束 DataValidationConstraint constraint helper.createExplicitListConstraint(values); DataValidation validation helper.createValidation(constraint, rangeList); // 显示下拉箭头 validation.setSuppressDropDownArrow(true); // 错误提示 validation.setErrorStyle(DataValidation.ErrorStyle.STOP); validation.setShowErrorBox(true); validation.createErrorBox(输入不合法, 请从下拉列表中选择不要手工输入); // 选中单元格时的提示 validation.setShowPromptBox(true); validation.createPromptBox(填写说明, 请从下拉框中选择); sheet.addValidationData(validation); }); } }几个细节我解释一下这些直接关系到功能能不能正常用第一CellRangeAddressList构造参数是(firstRow, lastRow, firstCol, lastCol)这里的行和列索引都是从0开始的。所以数据从第1行开始是因为第0行是表头。如果模板里表头占了两行那就要从2开始别想当然。第二MAX_ROW设为10000是给用户预留的填写空间。这个值不要设成Excel的最大行号1048576虽然技术上可行但文件打开时验证信息处理会慢文件也会变大。10000行对绝大多数业务场景都够用了。第三createExplicitListConstraint(values)传入的是一个String数组序列会直接内嵌到Sheet的XML里。这个方案简单直接但后面会讲到它有字符数限制选项特别多时不能这么用。3.3 完整代码实体类、Handler、Controller下载接口有了Handler剩下的就是搭建一个完整的下载接口。我用一个员工信息导入模板来做示例包含姓名、性别、部门、在职状态四列其中性别、部门、在职状态都做成下拉框。先写实体类。注意用ExcelProperty注解指定表头名称和列顺序import com.alibaba.excel.annotation.ExcelProperty; import com.alibaba.excel.annotation.write.style.ColumnWidth; import com.alibaba.excel.annotation.write.style.HeadRowHeight; import lombok.Data; Data HeadRowHeight(24) ColumnWidth(20) public class EmployeeImportVO { ExcelProperty(value 姓名, index 0) private String name; ExcelProperty(value 性别, index 1) private String gender; ExcelProperty(value 部门, index 2) private String department; ExcelProperty(value 在职状态, index 3) private String status; }index属性很重要。有些同事不加index就靠实体字段的顺序推断列顺序一旦后面有人调整字段顺序导出的列就乱套了。加上index能把列位置锁死是模板类实体里我建议养成的习惯。然后是Controller层。模板下载本质上是让后端把Excel二进制流写到HttpServletResponse的输出流里前端触发下载import com.alibaba.excel.EasyExcel; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import javax.servlet.ServletOutputStream; import javax.servlet.http.HttpServletResponse; import java.io.IOException; import java.net.URLEncoder; import java.nio.charset.StandardCharsets; import java.util.*; RestController RequestMapping(/excel) public class TemplateDownloadController { GetMapping(/template) public void downloadTemplate(HttpServletResponse response) throws IOException { // 下拉选项数据 MapInteger, String[] dropDownMap new HashMap(); dropDownMap.put(1, new String[]{男, 女}); dropDownMap.put(2, new String[]{技术部, 产品部, 运营部, 市场部, 人事行政部}); dropDownMap.put(3, new String[]{在职, 离职, 休假}); // 文件名编码避免中文乱码 String fileName URLEncoder.encode(员工信息导入模板, StandardCharsets.UTF_8) .replaceAll(\\, %20); response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setCharacterEncoding(utf-8); response.setHeader(Content-Disposition, attachment;filename*UTF-8 fileName .xlsx); try (ServletOutputStream out response.getOutputStream()) { EasyExcel.write(out, EmployeeImportVO.class) .registerWriteHandler(new DropDownWriteHandler(dropDownMap)) .sheet(员工信息) .doWrite(Collections.emptyList()); } } }这里有一个很多人会踩的点模板是用来给用户填的所以doWrite传的是空列表。EasyExcel收到空列表只会写表头不会写数据行但我们的afterSheetCreate钩子在创建Sheet时就执行了下拉框的作用区域已经设置好。所以模板看起来是一张只有表头的空表实际上下拉框已经覆盖了第2行到第10001行。如果你用POI原生代码写同样一个模板光表头样式和下拉框就要写七八十行。EasyExcel把表头那一堆琐事做了我们只需要补上下拉框这个特殊能力开发效率确实高一大截。3.4 验证效果Excel和WPS里分别怎么呈现这个模板下载到本地之后用Excel打开点开性别列任意一个单元格右侧会出现一个下拉箭头选择男或女没问题。如果用户非要手动输入一个未知回车之后Excel会弹出一个提示框内容是我们在代码里设置的请从下拉列表中选择不要手工输入。用WPS打开也能正常显示下拉框但有个小差异WPS对错误提示的渲染不如Excel严格。有时候用户手动输入违规值WPS只是标个红框不会像Excel那样强制拦截。所以别以为有了下拉框后端校验就可以省了——这是两码事。4. 进阶方案选项太多/太长时改用隐藏Sheet引用4.1 直接内联列表的255字符边界前面用的createExplicitListConstraint(values)内部实现是把选项拼成一个以逗号分隔的字符串写进Excel的数据验证公式formula11,男,女/formula1里。Excel对这个公式字符串的长度是有限制的大概在255个字符左右。这意味着什么如果你的部门列表有18个部门每个部门名字平均8个字光这些选项的字符数就可能超过255。超了之后Excel打开文件时会提示文件已损坏或者下拉框直接失效。WPS可能稍微宽容一点但也不能依赖它。另一种情况是选项数量特别多比如提供全国所有城市列表几百个选项全拼进一个公式里即使字符长度不超限这个下拉框用起来也非常卡。解决方案就是提前把选项放到一个隐藏Sheet的单元格里然后让数据验证公式引用这个区域。这相当于把选项的存储位置从公式内部挪到了单元格区域绕开了长度限制。4.2 隐藏Sheet 命名区域实现无限选项具体思路分三步第一步在Workbook里额外创建一个Sheet专门放下拉选项。为了方便维护给每个下拉列单独占一列比如性别选项放在A列部门选项放在B列。第二步把这个Sheet隐藏起来。Excel允许Sheet有hidden状态用户打开文件时看不到这个辅助Sheet但数据验证引用依然有效。第三步创建数据验证时不用createExplicitListConstraint改用createFormulaListConstraint公式直接引用隐藏Sheet的区域。下面是一个改版Handler的代码示意Override public void afterSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) { Sheet sheet writeSheetHolder.getSheet(); Workbook workbook writeWorkbookHolder.getWorkbook(); // 创建隐藏Sheet名字别用太长的中文避免公式引用问题 Sheet optionSheet workbook.createSheet(dictOptions); // 注意新Sheet在Workbook里的索引是1主模板Sheet是0 workbook.setSheetHidden(1, true); // 把下拉选项写入隐藏Sheet这里简化处理实际应该动态构建 String[] genders {男, 女}; for (int i 0; i genders.length; i) { Row row optionSheet.getRow(i); if (row null) { row optionSheet.createRow(i); } row.createCell(0).setCellValue(genders[i]); } // 数据验证引用隐藏Sheet区域 DataValidationHelper helper sheet.getDataValidationHelper(); CellRangeAddressList rangeList new CellRangeAddressList(1, MAX_ROW, 1, 1); DataValidationConstraint constraint helper.createFormulaListConstraint(dictOptions!$A$1:$A$2); DataValidation validation helper.createValidation(constraint, rangeList); validation.setSuppressDropDownArrow(true); sheet.addValidationData(validation); }用这个方案有个更稳的小技巧把隐藏Sheet的区域定义一个名称Name比如叫genderOptions让数据验证公式引用名称而不是直接引用dictOptions!$A$1:$A$2。这样即使以后调整了隐藏Sheet的结构名称会自动跟着区域走不需要改动验证规则。Name name workbook.createName(); name.setNameName(genderOptions); name.setRefersToFormula(dictOptions!$A$1:$A$2); // 数据验证引用名称 DataValidationConstraint constraint helper.createFormulaListConstraint(genderOptions);在EasyExcel和POI混用时还有一个注意点workbook.createSheet()创建的Sheet在Workbook里的索引是顺序递增的。第一个Sheet是模板本身索引0我们创建的隐藏Sheet是索引1所以setSheetHidden(1, true)没问题。但如果你的业务还要创建多个Sheet索引就得动态计算别写死。4.3 从数据库动态读取下拉选项列表缓存策略静态写死下拉选项只能应付Demo真实项目里部门列表、地区列表、状态字典多半在数据库里。动态读取的思路其实很简单查询字典表转成String数组放进dropDownMap后面的事和静态完全一样。ListDictItem deptList dictService.listByType(dept); String[] deptOptions deptList.stream() .map(DictItem::getName) .toArray(String[]::new);但这里有个性能细节值得好好设计。如果每次有人下载模板后端都去数据库查一遍字典表在高并发场景下很容易把数据库打垮。而且部门列表这种数据一天之内基本不会变完全没有必要实时查。我的做法是把它做成缓存数据量不大、访问量也不大的项目用一个ConcurrentHashMap做本地缓存服务启动时预热一次后台定时刷新比如每10分钟刷新一次。数据量中等、有Redis的项目把字典缓存到Redis里设置合理的过期时间。数据量大、需要动态感知变化的场景可以做版本号机制字典变更时更新一个版本号模板下载时比较版本号不一致再重新加载。对于部门下拉框这个需求说实话用本地缓存就够了。别为了炫技引入一套复杂缓存体系项目越简单越容易维护。4.4 级联下拉的扩展思路既然已经聊到下拉框顺便提一下级联下拉因为后台系统里经常出现选择省份后城市下拉跟着变的需求。Excel里做级联下拉核心是借助INDIRECT函数。思路是在隐藏Sheet里维护一份数据比如每个省份对应一个命名区域区域里放着该省的城市列表。省份列的数据验证引用省份列表区域。城市列的数据验证来源写成INDIRECT($A2)意思是根据当前行A列输入的值去查找同名区域作为下拉选项。这个方案能用但坑不少。最典型的是命名区域必须是工作簿级别的名称Sheet级别的名称INDIRECT经常会解析失败。另外用公式引用其他Sheet时Sheet名带空格要加单引号否则公式直接报错。如果你在生产环境真要搞级联下拉我的建议是先在本地用Excel手工建一个带级联验证的模板把这个模板导出到XML里看看Excel自己生成的验证规则长什么样照葫芦画瓢再在代码里生成比自己凭空猜公式要靠谱得多。5. 实战中爬过的坑和排查手册5.1 下拉框导出后不生效的几种原因先说最常见的现象代码写完下载模板打开一看下拉框根本没有。我排查过这类问题原因一般出在下面几个地方。一是作用区域写错了。CellRangeAddressList范围如果从0开始下拉框会覆盖表头那一行。表头被盖住还不算出问题问题是用户从第一行数据开始填时反而没有下拉箭头。排查方法很简单打开模板选中第2行的对应列看看数据验证里有没有规则如果第1行有验证、第2行没有那基本就是行索引偏移问题。二是Excel版本不兼容。如果你用老版本的xls格式HSSFWorkbook部分POI的数据验证API行为会不一样。前两年我就遇到过xls里下拉框带中文选项导出后打不开文件的情况。现在的方案里BaseWorkbook接口虽然统一了但底层实现差异还在。建议模板下载一律用xlsx格式别迁就老用户。三是隐藏Sheet引用失效。用了隐藏Sheet方案后如果隐藏Sheet的索引、名称在后续代码里被改动数据验证就成了空引用。Excel打开时会提示文件有问题然后用户点修复修复完你设置的下拉框就没了。四是数据验证的公式和区域拼接错了。createFormulaListConstraint传入的字符串引用的Sheet名里如果有空格必须加单引号比如dict options!$A$1:$A$10。不加单引号Excel解析公式时会把这个引用当作两个区域验证自然就失效了。排查这类问题其实有个笨办法但非常好用下载模板后把文件后缀改成.zip直接解压找到xl/worksheets/sheet1.xml看里面的dataValidations节点。你的下拉框信息全在里面一眼就能看出公式写没写对、区域设没设对。这个技巧帮我排查了很多POI相关的灵异问题。5.2 文件名中文乱码的前后端联调模板下载接口的后端代码里我见过最多的问题就是文件名乱码。原因在于HTTP响应头里的Content-Disposition字段不支持裸的中文字符必须做编码处理。很多人知道要编码但用的是URLEncoder.encode(fileName, UTF-8)结果空格被编码成号在响应头里号又会变成字面量加号下载下来的文件名就成了员工信息导入模板.xlsx。正确写法是编码后把替换成%20String fileName URLEncoder.encode(员工信息导入模板, StandardCharsets.UTF_8) .replaceAll(\\, %20);另外响应头里建议同时带filename和filename*两种格式。老版本浏览器认filename新版本浏览器认filename*。这样兼容性最好response.setHeader(Content-Disposition, attachment;filename fileName .xlsx;filename*UTF-8 fileName .xlsx);前端如果是用axios下载还有个容易踩的坑。responseType必须设置成blob否则后端传来的二进制流会被axios当成普通文本处理下载下来文件打不开。同时那个文件名的编码filename*是RFC 5987规范前端解析时处理起来不算友好很多团队干脆让后端额外通过响应头或者业务返回值把文件名传给前端省去解析的麻烦。我个人建议如果是内部后台系统直接把文件名作为接口参数传给前端或者后端在响应头里附带一个自定义头如X-File-Name前端优先取这个头取不到再用Content-Disposition。这样能少打好几天的联调扯皮。5.3 SpringBoot 3.x 与 EasyExcel 的依赖坑SpringBoot升级到3.x之后依赖冲突问题比2.x多了不少。EasyExcel的javax规范产物在SpringBoot 3的体系里可能出问题具体表现为启动报ClassNotFoundException或者运行时NoSuchMethodError。如果你项目是SpringBoot 3.2我的建议EasyExcel升到3.3.4以上这个版本开始对jakarta体系友好很多。如果升级EasyExcel还是有问题直接把EasyExcel排除掉用POI 5.2.x自己写模板下载。POI 5.x本身是兼容jakarta的用起来反而少一层适配。千万别在SpringBoot 3项目里硬压EasyExcel低版本然后靠Maven exclude硬凑那是给自己埋雷。再说一个版本太高的坑。之前项目里用了EasyExcel 4.0.0的预览版发现afterSheetCreate里拿到的WriteSheetHolder.getSheet()在某些情况下返回的是XSSFSheet但我的代码早期是按HSSFSheet强转的结果线上直接类型转换异常。后来统一改成Sheet接口问题才消失。这里想提醒的是POI提供的接口是分HSSFSheet和XSSFSheet两套的但操作Excel功能时尽量用接口类型别用具体实现类否则换个文件格式就崩。5.4 大数据量下的模板性能优化建议如果你的模板不只是给用户填几行而是要预置几千行数据、并且每行都要有下拉框的时候就要注意性能了。第一下拉框的作用区域不要贪大。我见过有人图省事下拉范围直接覆盖到1048576行结果文件下载没问题打开模板的时候Excel卡顿明显。合理做法是按业务预估最大填充行数给个1万行左右就足够了。如果真有人填到第10001行他完全可以自己复制下拉框不至于没法用。第二多个下拉列不要循环创建大量DataValidation对象。虽然POI创建验证对象的开销不算大但几百列、几千列地建对内存还是有压力。更稳的做法是如果很多列共用相同的下拉选项可以合并成一个作用区域来建验证规则。第三如果模板本身包含大量预置数据EasyExcel的流式写比普通写更省内存。EasyExcel在写数据时本身就做了流式处理但你如果自定义Handler里又额外写了一堆数据就得注意别在Handler里把整个数据集合都加载到内存里。Handler每次回调只做自己那一亩三分地的事全局数据尽量走引用而不是复制。最后再分享几个小经验这套东西我在两个项目里实际跑过第一批模板加了性别、在职状态、部门三个下拉框之后运营那边导回来的数据脏数据比例从原来的一成左右直接降到接近零。倒不是说下拉框能把所有问题拦住但至少把枚举值乱填这一类问题在源头干掉了。我还有两个建议第一模板文件名的版本号一定要打上。比如员工信息导入模板_v20250411.xlsx。业务方反馈问题的时候能直接告诉你他用的哪个版本你自己排查起来也省心。否则业务方手里攥着一份三个月前的旧模板你这边早就改了规则两边对不上排查一天也找不到原因。第二下拉框的错误提示文案要写得有人情味。我见过不少模板错误提示就俩字错误用户填错了一脸懵。你在代码里写清楚请从下拉列表中选择已经算是及格了。更进一步的玩法是在createPromptBox里写上这一列的具体要求用户选中单元格时就能看到说明这比单独发一份填写说明文档有用得多。最后再强调一次Excel模板的下拉框只是前端拦截后端入库前该做的参数校验、枚举校验、数据库查重一步都不能省。Excel层帮你挡住明面上的脏数据后端校验兜住那些绕过模板、直接调接口捣乱的两层配合才是完整方案。