解决PHP导出CSV中文乱码的关键是添加UTF-8 BOM头（\xEF\xBB\xBF），而非转码；需配合header('Content-Type: text/csv; charset=utf-8')，并在fputcsv前输出BOM，确保脚本文件本身为UTF-8无BOM格式。
导出 CSV 文件时中文乱码怎么解决
PHP 用 fputcsv 直接输出到浏览器，Excel 默认按 ANSI（如 GBK）打开，但 PHP 脚本通常是 UTF-8 编码，导致中文显示为方块或问号。
关键不是“转编码”，而是加 BOM 头骗 Excel 认成 UTF-8：
- 在
header后、写入数据前，先输出\xEF\xBB\xBF（UTF-8 BOM） - 不要用
iconv或mb_convert_encoding转成 GBK——现代系统不兼容，且会破坏特殊符号 - 确保整个脚本文件保存为 UTF-8 无 BOM 格式（编辑器里选对），否则 BOM 会重复出现，Excel 打开报错
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="data.csv"');
echo "\xEF\xBB\xBF"; // 必须紧接 header 之后
$fp = fopen('php://output', 'w');
fputcsv($fp, ['姓名', '邮箱', '注册时间']);
fputcsv($fp, ['张三', 'zhang@example.com', '2024-05-01']);
fclose($fp);
导出大量数据时内存溢出或超时怎么办
用 SELECT * 把全部数据读进数组再导出，几万行就可能撑爆 memory_limit 或触发 max_execution_time。
正确做法是边查边写，不缓存结果集：
立即学习“PHP免费学习笔记（深入）”；
- 用
PDO::FETCH_ASSOC+while ($row = $stmt->fetch())流式读取 - 每写 100 行调用一次
ob_flush()和flush()（需确认服务器允许） - 导出前加
set_time_limit(0)，但别忘了检查memory_limit是否设得足够（比如 256M） - 避免在循环里做 ORM 查询、格式化或关联查询——所有字段应在 SQL 中一次性查出
用 Laravel 的 Response::stream 导出要注意什么
Laravel 的流式响应看似省事，但默认不处理 BOM，也不自动设置 Content-Length，Excel 仍可能乱码或提示“文件损坏”。
必须手动干预响应头和输出内容：
- 回调函数内第一行就得输出
\xEF\xBB\xBF -
Content-Type必须显式设为text/csv; charset=utf-8，不能依赖 Laravel 默认的application/octet-stream - 不要在回调里调用
dd()、Log::info()或任何会缓冲/中断输出的操作 - 如果用了 Query Builder，记得加
->cursor()（Laravel 9+）或->chunkById()避免全量加载
return Response::stream(function () {
echo "\xEF\xBB\xBF";
$fp = fopen('php://output', 'w');
fputcsv($fp, ['id', 'name']);
User::cursor()->each(function ($user) use ($fp) {
fputcsv($fp, [$user->id, $user->name]);
});
fclose($fp);
}, 200, [
'Content-Type' => 'text/csv; charset=utf-8',
'Content-Disposition' => 'attachment; filename="users.csv"',
]);
导出 Excel（.xlsx）而不是 CSV 有哪些现实约束
真要生成 .xlsx，绕不开第三方库，而生产环境最常踩的坑不是功能，是资源和部署限制。
-
PhpSpreadsheet内存占用高：1 万行 × 10 列 ≈ 60–100MB 内存，比 CSV 高 5–10 倍 - 不支持流式写入（
writeToFile必须写完才发响应），无法边生成边下载，用户等待感强 - 部分共享主机禁用
zip扩展（PhpSpreadsheet 依赖它），报错Class ZipArchive not found - 如果只是想让 Excel 正常打开、支持公式或多 sheet，不如用 CSV + BOM——90% 场景够用，且零依赖
真正需要 .xlsx 的时候，优先考虑后台异步生成 + URL 下载，而不是同步响应。
