导出功能必须用response流式返回，设置正确content-type和content-disposition头，csv用fputcsv()、excel用phpoffice/phpspreadsheet，复用查询条件并限制行数，错误时需设对应响应头。
导出功能必须用 Response 流式返回，不能用视图渲染
API 导出本质是二进制文件传输，不是页面跳转。如果在控制器里写 return view('export') 或走重定向，前端拿到的是 HTML 字符串或 302 响应，根本不会触发下载。
正确做法是直接构造 Response，设置好 headers 并写入文件内容流：
-
Content-Type要匹配格式：CSV 用text/csv，Excel（xlsx）用application/vnd.openxmlformats-officedocument.spreadsheetml.sheet - 必须带
Content-Disposition: attachment; filename="xxx.xlsx"，否则浏览器可能尝试在线打开而非下载 - 大文件别用
file_get_contents()全部加载到内存，要用fopen()+fputcsv()（CSV）或PhpSpreadsheet\Writer\Xlsx的save('php://output')（Excel）
Laravel 10+ 默认不带 Excel 支持，得装 phpoffice/phpspreadsheet
官方没内置 Excel 导出能力，maatwebsite/excel 这个老库已停止维护，且 Laravel 10+ 不兼容。硬装会报 Class "Maatwebsite\Excel\Excel" not found 或依赖冲突。
推荐方案是直连 phpoffice/phpspreadsheet，轻量、无封装包袱、兼容性明确：
- 执行
composer require phpoffice/phpspreadsheet - 导出逻辑里用
PhpOffice\PhpSpreadsheet\Spreadsheet构建数据，再用PhpOffice\PhpSpreadsheet\Writer\Xlsx写出 - 注意：不要在
__construct()或中间件里初始化Spreadsheet实例，它占内存；每个请求新建即可
CSV 导出别手写拼接，用 fputcsv() 防止字段含逗号/换行出错
手动 implode(',', $row) 看似简单，但遇到字段含 ,、"、\n 就会破坏 CSV 结构，Excel 打开后列错位、多行乱码。
fputcsv() 自动加引号、转义，是 PHP 原生最稳的方案：
ob_start();
$fp = fopen('php://output', 'w');
fputcsv($fp, ['姓名', '邮箱', '备注']); // 表头
foreach ($data as $row) {
fputcsv($fp, $row); // 每行自动处理特殊字符
}
fclose($fp);
$output = ob_get_clean();
return response($output)
->header('Content-Type', 'text/csv')
->header('Content-Disposition', 'attachment; filename="users.csv"');
API 导出不能丢请求上下文，记得传 $request->query() 过滤条件
用户点“导出当前页筛选结果”，后端却导出全表，这是高频翻车点。API 导出路由和列表接口通常共用逻辑，但容易漏传参数。
关键动作是把查询条件从请求中显式提取、复用：
- 别在导出方法里重新写
User::all()，而是复用列表接口的 query builder - 例如：用
$query = User::query()->when($request->filled('status'), fn($q) => $q->where('status', $request->status)) - 导出前加
->limit(10000)是好习惯——防止用户无意触发百万行导出拖垮 DB 和内存
Content-Type。比如数据库查不到数据，返回 404 响应但 header 还是 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，前端就卡在“正在下载”状态，实际什么也没收到。大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
