在ThinkPHP导入Excel时，需严格按三步提取表头：先用IOFactory显式指定格式并加载真实路径文件，再动态获取首行范围或用getCellIterator遍历取getFormattedValue值，最后用trim和array_flip构建中文表头到字段的映射关系。
在ThinkPHP中导入Excel时，必须准确提取表头才能建立字段映射，否则数据库插入必然错位——比如把“手机号”列数据写进“用户ID”字段，且这种错误不会报SQL异常，只会静默污染数据。
先读取首行作为表头数组
第一步：用IOFactory::createReader()显式指定格式（【Xlsx或Xls必须与文件真实后缀严格一致】），避免Invalid reader异常。
第二步：调用$reader->load($file->getRealPath())加载文件，【不要用$_FILES['file']['tmp_name']直接传入】——TP可能已清理该临时文件，导致Could not open for reading!错误。
第三步：获取活动工作表后，用$worksheet->rangeToArray('A1:'.$columnLetter.$highestRow)一次性读取首行，其中$columnLetter需通过$worksheet->getHighestColumn()动态获取，硬写Z1会漏掉第27列之后的表头。
立即学习“PHP免费学习笔记（深入）”；
用getCellIterator逐列读取表头（推荐）
方法一：手动遍历第1行所有单元格，规避合并单元格干扰
① 调用$worksheet->getRowIterator(1)限定只读第1行；
② 对该行调用$row->getCellIterator()，再设$cellIterator->setIterateOnlyExistingCells(false)——否则跳过空列会导致索引偏移；
③ 遍历每个$cell，用$cell->getFormattedValue()取原始字符串，【别用getValue()】——它会把“2026-07-08”自动转成时间戳数字，表头变成45132而非日期文本。
④ 过滤掉全空单元格：trim($cell->getFormattedValue()) !== ''，防止Excel里留了不可见空格导致映射失败。
构建中文表头到数据库字段的映射关系
拿到表头数组后，不能直接按索引硬编码插入。例如$data['username'] = $rowData[0]，一旦Excel列序调整就崩。
用array_flip(array_map('trim', $header))生成键值对，如['用户名' => 0, '注册时间' => 4]；
后续每行数据都按字段名提取：$user['username'] = $rowData[$map['用户名']] ?? ''；
注意：中文表头常含空格或全角符号，trim()必须做，否则'用户名 ' ≠ '用户名'，映射失效。
