用header导出CSV而非Excel是因为PHP原生不支持生成真正的.xlsx文件，CSV方案更轻量、兼容性更好；必须添加UTF-8 BOM（\xEF\xBB\xBF）以避免Windows版Excel中文乱码；fputcsv可自动处理特殊字符转义，但需以数组形式传入字段，严禁手动拼接字符串。
为什么用 header 导出 CSV 而不是 Excel 文件
PHP 本身不生成真正的 .xlsx 文件，所谓“导出 Excel”在简单场景下基本等于“导出 CSV 并让浏览器用 Excel 打开”。header('Content-Type: text/csv') 配合正确的分隔符和编码，是最快、最轻量、兼容性最好的方案。Excel、WPS、Numbers 都能正常识别 UTF-8 编码的 CSV，前提是 BOM 头处理得当。
导出 CSV 必须加 UTF-8 BOM 吗
必须加，否则中文在 Windows 版 Excel 中大概率显示为乱码。Excel 默认用 ANSI（如 GBK）解析无 BOM 的 UTF-8 CSV，而其他系统（macOS/Linux）通常能自动识别。BOM 是三个字节 \xEF\xBB\xBF，必须在输出任何内容前写入。
- 不要用
echo "\xEF\xBB\xBF"后再 echo 数据 —— 如果之前有空格、换行或session_start()输出了 cookie，BOM 就失效 - 推荐方式：
fpassthru(fopen('php://output', 'w'))前先fputs($fp, "\xEF\xBB\xBF")，或更稳妥地用fputcsv+fopen('php://output', 'w')手动写 BOM - 注意：BOM 只对 UTF-8 有效；如果你用的是 GBK，就别加，但也不建议用 GBK —— 现代 PHP 环境默认 UTF-8
fputcsv 的坑：字段含逗号、换行、双引号怎么处理
fputcsv 会自动转义，但前提是字段是数组元素，且你没手动拼接字符串。常见错误是把整行拼成一个字符串再 echo，结果换行符被 Excel 当成新行，破坏结构。
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
- 正确做法：每行数据作为数组传给
fputcsv($fp, $row)，例如['张三', '运维部', "备注：需跟进\n2024-05"] -
fputcsv默认用双引号包裹含逗号/换行/双引号的字段，并将字段内双引号转义为两个双引号（Excel 兼容标准） - 不要改
$delimiter为中文逗号（如“，”）—— Excel 不认，会当成单字段 - 如果字段里有 HTML 标签或特殊符号，建议提前用
strip_tags()或htmlspecialchars_decode()清理，避免导出后格式错乱
完整可运行的最小导出示例
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="export_' . date('Y-m-d') . '.csv"');
header('Pragma: no-cache');
header('Expires: 0');
$fp = fopen('php://output', 'w');
fputs($fp, "\xEF\xBB\xBF"); // 写入 BOM
// 表头
fputcsv($fp, ['姓名', '部门', '入职日期', '备注']);
// 数据行（实际中从数据库 fetch）
$rows = [
['张三', '技术部', '2023-01-15', "试用期已过\n绩效A"],
['李四', '产品部', '2023-03-22', '远程办公'],
];
foreach ($rows as $row) {
fputcsv($fp, $row);
}
fclose($fp);
exit;
这段代码跑通的关键在于：BOM 在 fputcsv 前写入、没任何额外输出、没开启 output buffering（如有，请在开头加 ob_end_clean()）。一旦有 warning 或 notice 输出，header 就会失败，变成下载一个带错误信息的损坏 CSV。
立即学习“PHP免费学习笔记（深入）”；
真正麻烦的从来不是写几行 CSV，而是确保整个执行链路干净——没有 warning、没有空格、没有 session 输出、没有框架自动注入的 header。这点容易被忽略，但几乎占了线上导出失败问题的八成。
