Laravel-Excel 导出核心是选对版本并规范导出逻辑：先按 Laravel/PHP 版本安装 maatwebsite/excel 3.x 或 4.x，再用 FromQuery+lazy 处理大数据、headings 定义中文列头、map 格式化时间，避免内存溢出与乱码。
用 Laravel-Excel 导出 Excel 表格，核心就两步：装对包、写对导出逻辑。但很多人卡在版本兼容、队列配置或中文乱码上，不是插件不行，是没踩准 Laravel 版本和 PHP 环境的配合点。
确认 Laravel 和 PHP 版本再装包
maatwebsite/excel 从 3.x 升到 4.x 后不再支持 Laravel 8 以下版本，而 4.x 又要求 PHP ≥ 8.0。如果你用的是 Laravel 9 + PHP 8.1，直接运行：
composer require maatwebsite/excel
但如果项目还在 Laravel 7 或 PHP 7.4，必须锁版本：
composer require maatwebsite/excel:^3.1- 同时确保已安装
phpoffice/phpspreadsheet（3.x 会自动带，4.x 已剥离为独立依赖） - 别忘了在
config/app.php的providers数组里加Maatwebsite\Excel\ExcelServiceProvider::class（Laravel 5.5+ 可省略，但 6/7 仍需手动注册）
导出数据时别直接传 Eloquent 集合给 FromCollection
常见错误是把 User::all() 塞进 FromCollection 实现类，结果内存爆掉或中文字段名乱码。正确做法是：
- 用
select()显式指定字段，避免*拉取无用字段和关联数据 - 中文列头用
headings()方法单独定义，比如：return ['姓名', '邮箱', '注册时间']; - 时间字段用
map()转成可读格式：$row->created_at->format('Y-m-d H:i') - 如果数据量大（>5000 行），改用
FromQuery+lazy()，它按批拉取，不全量加载到内存
导出失败报 Class 'PhpOffice\PhpSpreadsheet\Writer\Xlsx' not found
这是典型的依赖未正确加载或自动加载失效。先检查：
- 运行
composer dump-autoload -o强制刷新 autoload - 确认
phpoffice/phpspreadsheet是否真的装上了（composer show phpoffice/phpspreadsheet） - 如果用了 Docker，可能 vendor 权限不对，进容器执行
chown -R www-data:www-data vendor/ - Laravel 4.x 默认用
Spout替代PhpSpreadsheet处理大文件，但 Spout 不支持公式和样式——若你需要加粗/合并单元格，必须切回PhpSpreadsheet并在config/excel.php中设'engine' => 'PhpSpreadsheet'
下载文件名含中文变成乱码或被截断
浏览器对 Content-Disposition 中文 filename 支持不一，最稳方案是只用 ASCII 文件名，比如：
return Excel::download(new UsersExport, 'users_'.date('Ymd_His').'.xlsx');
如果非要用中文名，得在响应头里做兼容处理：
- Chrome / Edge：用
filename*=UTF-8''%E7%94%A8%E6%88%B7%E5%AF%BC%E5%87%BA.xlsx（URL 编码） - Safari：仍推荐 fallback 到英文名，它对
filename*解析不稳定 - 别在
response()->download()里手动 setHeader，Excel::download()已封装好
真正麻烦的不是“怎么导出”，而是导出时要不要走队列、要不要加进度回调、要不要压缩包打包多个 Sheet——这些需求一出现，FromCollection 就不够用了，得切到 WithCustomValueBinder 或自定义 Writer 实例，这时候建议先看 phpspreadsheet 原生文档，而不是硬套 Laravel-Excel 封装层。
