laravel excel 3.1+ 移除全局 excel facade，需显式导入或依赖注入；导出大文件需调优内存与超时设置、分块查询、禁用重量级功能；csv/xlsx 底层差异大，中文文件名须 rfc 5987 编码。
composer require 后为什么 Excel 类找不到
因为 Laravel Excel 3.1+ 已彻底移除 Facade，Excel 不再是全局可调用的类。你写 Excel::download(...) 会直接报错 Class 'Excel' not found。
必须显式导入：用 use Maatwebsite\Excel\Facades\Excel;（仅限 Facade 场景），或更推荐——直接使用依赖注入方式传入 Maatwebsite\Excel\Excel 实例。
- Facade 方式需确认
config/app.php中已注册Maatwebsite\Excel\Facades\Excel别名（新版安装后默认不自动注册） - 如果你在命令行运行导出，且用了
php artisan tinker测试，记得先use Maatwebsite\Excel\Facades\Excel;，否则报错不提示原因 - Laravel 10+ 默认禁用 Facade 自动发现，
composer require maatwebsite/excel后务必手动执行php artisan vendor:publish --provider="Maatwebsite\Excel\ExcelServiceProvider"
导出时内存爆掉或超时，怎么改 php.ini 和 ini_set
Excel 导出本质是生成大数组再转为二进制流，尤其含图片、公式或上万行数据时，PHP 默认内存限制（128M）和执行时间（30s）根本扛不住。
不能只靠改 php.ini —— 生产环境往往不允许重启 PHP-FPM；得在导出逻辑里提前干预。
- 导出前加
ini_set('memory_limit', '512M');和set_time_limit(300);（注意：CLI 模式下set_time_limit(0)有效，FPM 下可能被 SAPI 层覆盖） - 避免一次性查全量数据：
DB::table('orders')->get()改成DB::table('orders')->cursor()->each(...)配合FromQuery导出，边查边写 - 禁用
withCharts()或withDrawings()等重量级功能，它们会显著拖慢速度并吃内存
导出 CSV 和 XLSX 的行为差异在哪
Maatwebsite\Excel\Concerns\WithHeadings 对 CSV 和 XLSX 处理一致，但底层引擎不同：CSV 用纯文本流，XLSX 用 PhpSpreadsheet 构建 ZIP 包，所以表现差异明显。
- CSV 不支持样式、合并单元格、日期格式化；导出含中文字段名时，必须加 BOM 头（
return response()->stream($callback, 200, ['Content-Type' => 'text/csv;charset=UTF-8'])并在回调开头 echo\xEF\xBB\xBF） - XLSX 导出若含时间字段，默认转成 Excel 时间戳（如
44926.5），需实现WithMapping手动格式化：return $row->created_at->format('Y-m-d H:i:s'); - 用
ShouldAutoSize自适应列宽？XLSX 支持，CSV 完全忽略 —— 这个 trait 只对 XLSX 生效
导出文件名乱码（尤其是中文）怎么修
不是浏览器问题，是 HTTP 响应头里 Content-Disposition 的 filename 参数没做 RFC 5987 编码。
Laravel Excel 默认用 urlencode()，但 Chrome/Firefox 要求 UTF-8 文件名必须用 filename*=UTF-8''... 格式。
- 别用
return Excel::download(new UsersExport, '用户列表.xlsx');这种简写 —— 它走默认逻辑，中文名大概率乱码 - 改用响应对象手动构造：
return Excel::download(new UsersExport, '用户列表.xlsx')->withHeaders(['Content-Disposition' => 'attachment; filename*=UTF-8\'\'%E7%94%A8%E6%88%B7%E5%88%97%E8%A1%A8.xlsx']); - 更稳妥的做法：在 Export 类里重写
fileName()方法，返回原始字符串，再配合registerEvents()在AfterSheet事件里不操作文件名，只专注内容
真正麻烦的是 IE11，它根本不认 filename*，得单独 UA 判断回退到 filename + GBK 编码 —— 除非你还得兼容它，否则现在基本可以忽略。
