ThinkPHP导入Excel如何读取多张工作表 操作教程详解

ThinkPHP导入Excel需显式遍历所有工作表，先用getSheetCount()和getSheetNames()获取表名列表，再按名称（推荐）、索引（慎用）或遍历方式读取；读取时应激活工作表、获取有效行列范围、流式迭代非空行，并手动处理合并单元格。

ThinkPHP导入Excel时默认只读取第一个工作表，但实际业务中常需处理多张工作表（如“用户信息”“订单明细”“统计汇总”分别在不同sheet），必须显式遍历所有工作表并按需提取数据。

获取全部工作表名称列表

先确认Excel里到底有几张表、叫什么名字，避免硬编码索引出错。
调用$spreadsheet->getSheetCount()获取总数，再用getSheetNames()拿到所有名称数组。

这一步不能跳过——有些Excel文件开头藏了隐藏表或空表，直接getSheet(0)会漏掉关键数据。

逐个读取指定名称的工作表

方法一：按名称精确读取（推荐）
用$spreadsheet->getSheetByName('销售数据')直接定位，名称区分大小写，不存在则返回null。

立即学习“PHP免费学习笔记（深入）”；

方法二：按索引顺序读取（慎用）
用$spreadsheet->getSheet($index)，索引从0开始。⚠️注意：【索引顺序不等于Excel底部标签排列顺序】，因用户可能拖动重排过sheet位置，靠索引易错位。

方法三：遍历全部工作表统一处理
用foreach ($spreadsheet->getAllSheets() as $sheet)，每张表都执行相同清洗逻辑，适合模板化结构的多sheet报表。

安全读取每张表的数据行

第一步：激活当前工作表
$worksheet = $spreadsheet->setActiveSheetIndexByName('用户表');

第二步：获取有效行范围
调用$worksheet->getHighestRow()和$worksheet->getHighestColumn()，不要依赖toArray()——它会把整张表（含合并单元格残留、隐藏行）全载入内存，10万行+多sheet极易触发OOM。

第三步：流式遍历非空行
用$worksheet->getRowIterator()逐行迭代，配合$cellIterator->setIterateOnlyExistingCells(true)跳过空白单元格，再用array_filter($rowData)过滤全空行。

第四步：手动处理合并单元格
PhpSpreadsheet不会自动填充合并单元格值，需用$worksheet->mergeCells反查范围，对$worksheet->getCell("A1")->getValue()为null但所在区域被合并的情况，主动调用$worksheet->getCell("A1")->getOldCalculatedValue()或缓存上一行同列值。