直接用PhpSpreadsheet导出需确保四点：正确自动加载（引入vendor/autoload.php）、设置响应头（Content-Type/Disposition等）、清空输出缓冲（ob_end_clean()）、合理控制内存（避免逐单元格写入、启用缓存或分批处理）。
直接用 PhpOffice\PhpSpreadsheet\IOFactory::load() 或 new Spreadsheet() 就能导出，但不处理自动加载、响应头、内存和缓冲区，90% 的“空白文件”“Class not found”“乱码下载”都源于这四点。
Class not found 错误：Yii2 没注册 PhpSpreadsheet 的 PSR-4 自动加载
Composer 安装完 phpoffice/phpspreadsheet 后，类文件确实在 vendor/phpoffice/phpspreadsheet/src，但 Yii2 默认只加载自己命名空间（app\、yii\）和 Composer 的 autoload_psr4.php —— 而 PhpSpreadsheet 的根命名空间是 PhpOffice，没被映射到路径，所以 new \PhpOffice\PhpSpreadsheet\Spreadsheet() 仍报错。
实操建议：
解析 MySQL 8.0 的 DDL 脚本，并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景，导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理，每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。
- 确认
vendor/autoload.php已在web/index.php中引入（标准 Yii2 模板默认已做，但自定义入口或 console 脚本容易漏） - 不要手动
require任何.php文件，硬引会破坏命名空间解析 - 如使用老版本 Yii2（aliases，需显式添加：
'@PhpOffice' => '@vendor/phpoffice/phpspreadsheet/src'到config/web.php的aliases数组中
导出后浏览器打开失败或乱码：响应头缺失或顺序错误
Yii2 不会自动设置 Excel 下载所需的 Content-Type 和 Content-Disposition，漏设或晚于输出内容发送，就会导致文件损坏、被当网页渲染、或下载后打不开。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 必须在调用
$writer->save('php://output')前，手动设置响应头 - 务必先执行
ob_end_clean()清空已有输出缓冲——Yii2 Debug Toolbar、日志、甚至 PHP 文件末尾的空格都可能提前触发 headers 已发送 - 典型响应头组合：
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');header('Content-Disposition: attachment; filename="data.xlsx"');header('Cache-Control: max-age=0');
大数据导出内存溢出或超时：默认全量加载进内存
Spreadsheet 对象默认把所有单元格缓存在 PHP 内存里，10 万行 × 50 列就很容易突破 512MB 限制，报 Fatal error: Allowed memory size exhausted 或生成空白文件。
实操建议：
- 避免用
getActiveSheet()->setCellValue()在循环中逐单元格写入——改用$worksheet->fromArray($data)批量导入二维数组，性能高 10 倍以上 - 大数据场景优先写入临时文件：
$writer->save('/tmp/export_' . time() . '.xlsx');
再用Yii::$app->response->sendFile()推送，绕过内存瓶颈 - 如必须流式输出，启用缓存策略：
\PhpOffice\PhpSpreadsheet\Settings::setCacheStorageMethod(\PhpOffice\PhpSpreadsheet\Settings::CACHE_TO_PHP_TMP);
读取 Excel 报 “Invalid file format” 或跳过部分 sheet：未正确识别格式或未指定工作表
IOFactory::load() 依赖文件扩展名和魔数判断格式，若文件后缀是 .xls 但实际是 xlsx 内容（或反之），或文件被其他程序静默修改过，就会报错；另外新版 PhpSpreadsheet 不再自动激活第一个 sheet，getActiveSheet() 可能返回 null。
实操建议：
- 读取前先用
IOFactory::identify($filePath)确认真实格式，再显式调用对应 Reader，例如：$reader = IOFactory::createReader('Xlsx'); - 别假设只有一页表，显式获取目标 sheet：
$spreadsheet->getSheet(0)或$spreadsheet->getSheetByName('Sheet1') - 读取时加
$reader->setReadDataOnly(true)跳过样式/公式，提速且降低出错概率
最易被忽略的是 ob_end_clean() —— 它不是可选项，而是导出链上不可跳过的一步。哪怕只是多了一个空格、一段调试 var_dump 或一个未关闭的 ob_start()，都会让 header 失效，最终用户收到一个“能下载但打不开”的文件。
