Laravel怎么导出Excel表格_Laravel-Excel插件安装与使用【必备】

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 数组里加 MaatwebsiteExcelExcelServiceProvider::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 'PhpOfficePhpSpreadsheetWriterXlsx' 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 封装层。