maatwebsite/excel 导出需用 FromCollection 封装、避免全量加载、配合 WithHeadings/WithStyles 等接口控制格式，Laravel 9+ 必用 ^3.1 版并正确配置；大数据须分块、禁用自动宽、改用队列导出。
用 maatwebsite/excel 导出 Excel，核心是「不手动拼 HTML 表格」，也不用直接操作底层 PHPExcel 或 PhpSpreadsheet —— 它封装了导出逻辑，但必须理解它怎么绑定数据、怎么控制格式、怎么避免内存爆炸。
安装与基础配置必须做对这三步
很多人卡在第一步就报错：Class 'Maatwebsite\Excel\ExcelServiceProvider' not found 或导出时提示 Class 'PhpOffice\PhpSpreadsheet\Writer\Xlsx' not found。本质是 Laravel 版本和扩展版本不匹配，或未完成自动发现/手动注册。
- Laravel 9+ 必须用
maatwebsite/excel ^3.1（对应 PhpSpreadsheet），不能装 v2.x（那是旧版，只支持 Laravel 5.8–8.x） - 运行
composer require maatwebsite/excel后，Laravel 9+ 无需手动php artisan vendor:publish，但需确认config/excel.php存在；若不存在，执行php artisan vendor:publish --provider="Maatwebsite\Excel\ExcelServiceProvider" - 检查
APP_URL是否配置正确，否则导出时生成临时文件路径可能失败（尤其在 CLI 环境下）
导出单个查询结果最稳妥的方式：用 Collection + 导出类
别直接在控制器里写 Excel::download(...) 一行导出 —— 数据量大时会 OOM，且无法复用、无法测试。推荐封装为独立导出类，配合 FromCollection 接口。
- 生成导出类：
php artisan make:export UsersExport - 在
app/Exports/UsersExport.php中实现FromCollection，并重写collection()方法，返回Illuminate\Support\Collection，不是 Eloquent Collection 也不是数组 - 避免在
collection()里调User::get()—— 这会一次性加载全部数据到内存；改用User::cursor()->map(...)->collect()或分块（chunkById）处理超大数据集 - 导出触发代码保持简洁：
return new UsersExport();
（在控制器中直接 return，Laravel-Excel 自动识别并响应）
导出带表头、样式、多工作表的要点
默认导出是纯数据，无标题行、无样式、单 sheet。要加这些，得用 WithHeadings、WithStyles、WithMultipleSheets 等接口，但注意它们的生效时机和限制。
-
WithHeadings要求导出类实现headings(): array，返回一维字符串数组，顺序必须和map()或collection()返回项的键顺序严格一致 -
WithStyles的styles()方法返回二维数组，键是 Excel 单元格坐标（如'A1'），值是样式数组；但注意：它只对当前 sheet 生效，且不支持条件格式 - 多 sheet 导出必须实现
WithMultipleSheets，并在sheets()中返回多个导出类实例（每个实例对应一个 sheet），不能靠循环写入同一实例 - 日期字段默认导出为时间戳数字？在
map()中显式用Carbon::parse($user->created_at)->format('Y-m-d H:i')格式化，否则 Excel 打开后显示为 44205 这类数字
大文件导出失败、内存溢出、超时的常见解法
导出 10 万行以上数据时，memory_limit=256M 和 max_execution_time=30 是默认杀手。Laravel-Excel 本身不解决这些问题，你得主动干预。
- 禁用预加载：在导出类中加
public $shouldAutoSize = false;，否则自动列宽计算会遍历全部单元格，吃光内存 - 关闭公式计算：在
registerEvents()中设置setCalculationEngine(null)，防止意外触发公式解析 - 使用
ShouldAutoSize替代$shouldAutoSize = true（v3.1+ 支持），它更轻量 - 真正的大数据场景（如 >50 万行），放弃实时下载，改为队列生成文件 + 前端轮询下载链接；用
store()方法存到storage/app或 S3，并返回 URL
最容易被忽略的是：导出类里的 map() 方法如果返回 null 或空数组，整个 sheet 会空白且无报错；还有就是中文表头在 Windows Excel 里乱码，其实是编码没问题，而是字体缺失 —— 换成 SimSun 或 Microsoft YaHei 字体可解。
