导出Excel需满足透视表前提：数据为键名一致的二维数组，用array_values重置索引，清除null/空值/对象；从A1写入，首行为严格表头，无空行空列，禁用合并与边框；日期列设DateTime格式。
你需要在ThinkPHP项目中导出Excel文件，并让业务人员能直接在Excel里做自动筛选、快速生成透视表——这要求导出的Excel结构规范、字段清晰、无合并单元格、无空行空列，否则Excel打开后右键“数据透视表”会灰掉或报错。
确保导出的Excel满足透视表前提条件
第一步：确认数据库查询结果已转为二维数组，且每条记录键名与表头完全一致，例如['id', 'product_name', 'region', 'sales', 'date']；键名必须是纯英文或拼音，不能含中文、空格、特殊符号。
第二步：导出前用array_values()重置所有子数组的数字索引，避免因键顺序不一致导致列错位；同时检查是否混入了null、空字符串或对象实例——这些会在Excel中显示为#VALUE!或空白，破坏数据连续性。
第三步：写入Excel时，【必须从A1单元格开始写入，且第一行为严格表头，表头下方紧接数据，中间不能有任何空行】。PHPExcel或PhpSpreadsheet都不校验空行，但Excel客户端读取时会把第一个空行当作数据区域终点，后续数据被忽略。
立即学习“PHP免费学习笔记（深入）”；
ThinkPHP中导出带格式的规范Excel（以PhpSpreadsheet为例）
方法一：使用PhpSpreadsheet直接写入（推荐）
① 在控制器中引入：use PhpOffice\PhpSpreadsheet\Spreadsheet; 和 use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
② 实例化并设置表头：$spreadsheet = new Spreadsheet(); $sheet = $spreadsheet->getActiveSheet(); $headers = ['ID', '商品名称', '所属地区', '销售额', '日期']; foreach ($headers as $col => $header) { $sheet->setCellValueByColumnAndRow($col + 1, 1, $header); }
③ 写入数据行：从第2行开始循环写入，【禁止使用mergeCells()、setBorder()等破坏单元格独立性的操作】，每一行都必须是完整、独立、无格式干扰的纯数据行。
④ 设置列宽（可选）：如$sheet->getColumnDimension('D')->setWidth(12);，防止数值列显示为科学计数法；日期列建议设为DateTime类型并应用格式'yyyy-mm-dd'，否则透视表无法按年/月分组。
Excel端启用自动筛选与创建透视表
导出文件下载后，在Windows版Excel（2016及以上）或WPS表格（开启兼容模式）中双击打开：
→ 选中任意一个有数据的单元格（不必全选）
→ 按快捷键 Ctrl + T，弹出“创建表”对话框 → 勾选“表包含标题”，点击确定。此时整个数据区域被识别为结构化表格，自动筛选下拉箭头立即出现在每个列标题右侧。
→ 保持该表格处于选中状态，点击“插入”选项卡 → “数据透视表” → 接受默认选项（新工作表）→ 点击确定。空白透视表生成，右侧“字段列表”窗格自动展开，所有列名已就绪可拖拽。
注意：如果点击“数据透视表”按钮是灰色的，说明当前活动单元格不在规范表格内，或Excel误判了数据区域边界——此时需手动按Ctrl + A全选数据区，再按Ctrl + T重建表格。
