Excel 打开 UTF-8 CSV 时,若无 BOM (Byte Order Mark: EF BB BF),会按系统默认编码(中文 Windows 为 GBK)解码,导致中文乱码。记事本/CSV 编辑器通常能自动检测 UTF-8 无 BOM 正常显示。
<?php
$file = fopen('export.csv', 'w');
// 写入 BOM
fwrite($file, "\xEF\xBB\xBF"); // 或 chr(0xEF).chr(0xBB).chr(0xBF)
$headers = array('ID', '姓名', '邮箱');
fputcsv($file, $headers);
$data = array(
array(1, '张三', 'zhang@example.com'),
array(2, '李四', 'li@example.com'),
);
foreach ($data as $row) {
fputcsv($file, $row);
}
fclose($file);
$fp = fopen('export_gbk.csv', 'w');
foreach ($rows as $row) {
// 每个字段转编码
$row = array_map(function($v) {
return mb_convert_encoding($v, 'GBK', 'UTF-8');
}, $row);
fputcsv($fp, $row);
}
fclose($fp);
// 下载响应头
header('Content-Type: application/csv; charset=GBK');
header('Content-Disposition: attachment; filename="export.csv"');
readfile('export_gbk.csv');
League\Csv(推荐现代项目)
// composer require league/csv
use League\Csv\Writer;
$csv = Writer::createFromFileObject(new SplTempFileObject());
$csv->setOutputBOM(Writer::BOM_UTF8); // 自动加 BOM
$csv->insertOne(['ID', '姓名', '邮箱']);
$csv->insertAll($data);
header('Content-Type: text/csv; charset=UTF-8');
header('Content-Disposition: attachment; filename="export.csv"');
$csv->output('export.csv');
| 方案 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| UTF-8 + BOM | 代码最少,Excel 2016+ 完美支持 | 极老版本 Excel 可能不识别 BOM | 现代办公环境首选 |
| GBK 转码 | 兼容所有中文 Excel 版本 | 需逐字段转码,性能稍差;不支持生僻字/Emoji | 老旧系统、政府/银行导出 |
| League\Csv | 功能全(分块、转换、验证),自动 BOM | 引入依赖 | 新项目、复杂导出 |
// 生成器分块输出,避免内存溢出
function exportLargeCsv() {
header('Content-Type: text/csv; charset=UTF-8');
header('Content-Disposition: attachment; filename="big.csv"');
echo "\xEF\xBB\xBF"; // BOM
$out = fopen('php://output', 'w');
fputcsv($out, ['ID', 'Name']);
foreach (range(1, 1000000) as $i) {
fputcsv($out, [$i, "Name $i"]);
if ($i % 10000 === 0) { flush(); ob_flush(); }
}
fclose($out);
}