新版 laravel-excel 3.1+ 移除了 excel facade 别名，需用依赖注入或手动注册门面；导入需实现 withheadingrow 等接口并配合 withchunkreading 分批处理；导出注意响应头、编码及样式接口仅对 xlsx 生效。
composer require 后为什么 Excel 类找不到？
装完 maatwebsite/excel 但一用就报 Class 'Excel' not found，不是没装好，是新版（3.1+）彻底移除了 Facade 别名。Laravel-Excel 从 3.x 开始强制走依赖注入或门面手动注册。
- 不推荐继续用
Excel::import()这种全局静态调用，它只在 2.x 存在 - 正确做法是：在控制器里用构造函数注入
Importabletrait 或直接 type-hintMaatwebsite\Excel\Excel实例（实际很少直接用这个类） - 更常用的是让导入类实现
WithHeadingRow、WithValidation等接口，再用Excel::import(new UsersImport, $request->file('file')) - 别忘了在
config/app.php的providers里加Maatwebsite\Excel\ExcelServiceProvider::class（Laravel 5.5+ 自动发现，但若关闭了 auto-discovery 就必须手动加）
导入时日期/数字被转成科学计数或 1970-01-01？
Excel 原生不存“日期类型”，它存的是自 1900-01-01 起的天数浮点值；PHP 读出来就是个数字，比如 44197.5。不显式转换，PhpSpreadsheet 底层会按默认格式解析失败。
- 在导入类里实现
WithCustomValueBinder接口，重写bindValue()方法，对日期列用DateTime::createFromFormat('Y-m-d', ...)处理 - 或者更简单：在模型的
$casts里声明'created_at' => 'datetime'，但前提是 Excel 里该列确实是标准日期字符串（如2023-10-05），而不是 Excel 序列号 - 数字列被转成
1.23E+10？那是 PhpSpreadsheet 默认启用自动类型推断，加WithStrictNullComparison没用，得在config/excel.php里设'strict_nulls' => true并配合WithChunkReading手动控制单元格读取逻辑
大文件导入卡死或内存爆掉怎么办？
Excel::import() 默认把整张表加载进内存，10 万行 Excel 很容易吃光 512MB 内存。不是 PHP 配置调高就行，得换策略。
Excel XLSX Formula Cleanup
下载
诊断并修复涉及公式、命名范围、Power Query 刷新、数据透视表、VBA/宏保存等问题的 Microsoft Excel XLSX 工作簿
- 必须用
WithChunkReading接口，配合$chunkSize = 1000分批处理，每批走一次 DB 插入 - 别在 chunk 里调
Model::create()一万次，改用Model::upsert($data, ['email'], ['name', 'updated_at'])（Laravel 9+）或DB::table()->insert() - 临时关闭模型事件和 Observer：
Model::withoutEvents(fn() => User::insert($chunk))，否则每个模型实例都触发 creating/created，性能跌 3 倍以上 - 注意：开启
WithChunkReading后，WithValidation会失效——验证只能在 chunk 内做，不能跨块校验唯一性
导出时中文表头乱码或样式丢失？
导出本质是生成 .xlsx 文件，但浏览器下载时若响应头不对，Excel 会用 ANSI 解析 UTF-8 字符，结果表头变 ???；样式丢失则多因模板写法错位。
- 确保控制器返回的是
return Excel::download(new UsersExport, 'users.xlsx');，不要自己 echo 或用response()->stream()包裹 - 如果导出 CSV（不是 XLSX），必须在
UsersExport类里实现map()并对每个字段做mb_convert_encoding($value, 'GBK', 'UTF-8')，否则 Excel for Windows 打开必乱码 - 想加背景色/冻结首行？别在
collection()里 return 数组，改用FromCollection+WithStyles接口，在styles()方法里返回类似['A1:C1' => ['font' => ['bold' => true]]]的数组 - 样式接口只对 XLSX 生效，CSV 导出不支持任何格式 —— 这点容易被文档带偏
最常被忽略的是：Laravel-Excel 的 WithHeadingRow 只影响导入，不影响导出；导出的表头由 headings() 方法决定，且它返回的数组键名不会自动映射到数据列——必须和 map() 或 collection() 返回的结构严格对齐，否则空列或错位。
