TP5导出Excel核心是按量级和格式分路径：大数据量必须用cursor()+fputcsv导CSV，禁用框架封装；小批量且需Excel时，用PhpSpreadsheet分块fromArray写入、禁计算引擎、加BOM头、配全响应头并exit。
TP5 导出 Excel 不是“装个包就能用”，核心矛盾在内存和格式兼容性上——直接 Db::select() 查 5 万条再喂给 PhpSpreadsheet，99% 会触发 Fatal error: Allowed memory size exhausted；而用 HTML 表格伪造 Excel（downloadExcel() 那种），打开就是乱码或样式崩溃。必须按量级、格式、稳定性分路径处理。
大数据量导出必须用 CSV + cursor()，别碰 Excel
Excel 格式本身不支持流式写入，PhpSpreadsheet 写入过程会缓存全部单元格对象，数据量一过 1 万行，内存占用轻松破 300MB。此时强行导 Excel 就是给自己埋雷。
- 用
Db::name('user')->cursor()替代select()，逐行取数据，内存恒定在几 MB - 输出前必须加 BOM 头：
echo "\xEF\xBB\xBF";，否则 Excel 默认用 ANSI 解码中文字段，全成问号 - 用原生
fputcsv()，别用框架封装的 exportCsv 方法——字段顺序、空值转空字符串、引号/换行自动转义都由它兜底 -
ob_end_clean()必须调用，否则响应体开头混入空白或 HTML，CSV 文件就损坏
小批量且硬要 Excel：用 PhpSpreadsheet + fromArray() 分块写入
若业务明确要求 .xlsx（比如要公式、条件格式、合并单元格），PhpSpreadsheet 是唯一靠谱选择，但初始化和写入节奏必须控制。
- 禁用计算引擎：
$spreadsheet->setCalculationEngine(new \PhpOffice\PhpSpreadsheet\Calculation\Calculation());，否则读写含公式的文件时 CPU 爆表 - 避免逐单元格赋值：
$sheet->setCellValue('A'.$row, $val)写 1 万行 = 1 万个 PHP 对象，内存翻倍；改用fromArray($chunk, null, 'A2')批量写入 - 分块写入：每 500 行 flush 一次，
$writer->save('php://output')只在最后调用一次，中间用ob_flush()推送缓冲区 - 不要用
new \PHPExcel()——这是已废弃的旧库，TP5.0 官方也不再兼容，composer require 的必须是phpoffice/phpspreadsheet
TP5.0 里加载 PhpSpreadsheet 的正确姿势
TP5.0 自带类自动加载机制，但 PhpSpreadsheet 的命名空间和目录结构与 TP 规范不完全对齐，直接 use 会报错。
立即学习“PHP免费学习笔记（深入）”；
- 安装后，在控制器顶部写完整命名空间：
use PhpOffice\PhpSpreadsheet\Spreadsheet;和use PhpOffice\PhpSpreadsheet\Writer\Xlsx; - 别在
common.php里写全局函数封装PhpSpreadsheet实例——每次调用都 new 一遍，对象无法复用，内存泄漏更隐蔽 - 如果非要用函数封装，务必加
static $spreadsheet = null;缓存实例，并在函数末尾unset($spreadsheet);显式释放 - vendor/autoload.php 已自动注册 PSR-4 加载器，无需再手动
Loader::import()或 require_once
导出响应头不能只写 Content-Type
只设 Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，浏览器可能识别为下载失败或弹窗拦截。必须配齐关键头。
- Excel 下载必须加：
header('Cache-Control: max-age=0');，否则某些 IE/Edge 版本会缓存旧文件 - 文件名含中文时，
filename=后面要用rawurlencode()编码，而不是iconv()转 GB2312——后者在 Linux 服务器上常因 locale 缺失直接报错 - 一定要有
Content-Disposition: attachment; filename="data.xlsx"，漏掉attachment会导致浏览器内联打开，不是下载 - 导出结束必须
exit;或die;，否则后续框架输出（如调试信息、布局模板）会污染二进制流
真正卡住人的从来不是“怎么写第一行代码”，而是导出 5w 行时内存爆了没日志、中文字段在 Excel 里显示为乱码却查不出哪少了个 BOM、或者导出接口被 CDN 缓存导致用户总下到旧数据——这些点不提前踩一遍，上线就是救火现场。
