ThinkPHP 5 默认不支持 PhpSpreadsheet 是因自动加载机制未识别 PSR-4 命名空间，需在 common.php 中用 Loader::addNamespace() 注册 'PhpOffice' 命名空间指向 src/ 目录，导出时须清理缓冲、设置正确响应头。
ThinkPHP 5 默认不支持 PhpSpreadsheet，直接 composer require phpoffice/phpspreadsheet 后调用会报类找不到或自动加载失败——根本原因是 TP5 的自动加载机制未识别 PSR-4 命名空间。
为什么 new \PhpOffice\PhpSpreadsheet\Spreadsheet() 报错 Class not found
TP5.0/5.1 使用自己的 Loader 类处理类加载，而 phpoffice/phpspreadsheet 是标准 PSR-4 结构，其命名空间 PhpOffice\PhpSpreadsheet 不在 TP5 默认的加载映射里。Composer 安装后文件虽在 vendor/ 下，但 TP5 不会主动扫描该目录下的 PSR-4 命名空间。
- 不是 Composer 没装好，
vendor/autoload.php确实存在且可手动引入 - 不是路径写错，
use PhpOffice\PhpSpreadsheet\Spreadsheet;在 TP5 控制器里直接写会解析失败 - TP5.0 的
Loader::addNamespace()只支持扁平化命名空间（如Org\Util），不支持多级反斜杠嵌套
正确引入 PhpSpreadsheet 的两种方式（推荐后者）
方式一：在控制器顶部手动引入 Composer 自动加载器（简单但不优雅）
// 在控制器方法开头或构造函数中 require_once VENDOR_PATH . 'autoload.php';
方式二：在 application/common.php 中注册 PSR-4 命名空间（推荐，一次配置全局生效）
立即学习“PHP免费学习笔记（深入）”；
// application/common.php 最底部追加
if (function_exists('think\Loader::addNamespace')) {
think\Loader::addNamespace('PhpOffice', VENDOR_PATH . 'phpoffice/phpspreadsheet/src/');
}
- 注意路径必须指向
src/目录，不是vendor/phpoffice/phpspreadsheet/根目录 -
VENDOR_PATH是 TP5 内置常量，等价于ROOT_PATH . 'vendor/' - 注册后即可正常使用
use PhpOffice\PhpSpreadsheet\Spreadsheet;
导出 Excel 时中文乱码、样式丢失、内存溢出的常见原因
TP5 默认输出响应头是 text/html，而 Excel 导出必须强制设置为 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，否则浏览器会尝试渲染为 HTML 或下载后打不开。
- 漏设
Content-Type和Content-Disposition头，导致文件被当成网页打开或下载后损坏 - 用
$writer->save('php://output')但没关掉 TP5 的模板输出缓冲（ob_end_clean()必须调用） - 大数据量导出未启用
MemoryCache或分批写入，触发 PHP 内存限制（默认 128M 不够） - 中文标题用
$sheet->setCellValue('A1', '姓名')没问题，但若用setCellValueByColumnAndRow()传参顺序写反，列行颠倒会导致写到错误单元格
一个最小可用导出示例（含 HTTP 头 + 缓冲清理）
以下代码可直接放在 TP5 控制器方法中运行：
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
public function export()
{
$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
$sheet->setCellValue('A1', 'ID')->setCellValue('B1', '姓名')->setCellValue('C1', '时间');
$data = [['1', '张三', date('Y-m-d H:i:s')], ['2', '李四', date('Y-m-d H:i:s')]];
$row = 2;
foreach ($data as $item) {
$sheet->fromArray($item, null, 'A' . $row);
$row++;
}
ob_end_clean(); // 关键：清空输出缓冲，避免 header 冲突
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment;filename="user_export_' . date('YmdHis') . '.xlsx"');
header('Cache-Control: max-age=0');
$writer = new Xlsx($spreadsheet);
$writer->save('php://output');
}
如果项目已启用 debug 模式，TP5 日志可能提前输出了 warning，导致 header 发送失败——此时需确保导出逻辑前无任何 echo/print/debug 输出。
