php 导出 csv 时中文显示为问号（???），主因是缺少 utf-8 bom 头且响应头声明不规范；本文详解如何通过添加 bom、修正 http 头及统一编码处理，确保 excel 和主流工具正确识别中文。
php 导出 csv 时中文显示为问号（???），主因是缺少 utf-8 bom 头且响应头声明不规范；本文详解如何通过添加 bom、修正 http 头及统一编码处理，确保 excel 和主流工具正确识别中文。
在 PHP 中导出含中文的 CSV 文件常遇到乱码问题——英文正常，中文却显示为 ???。这并非数据本身损坏，而是字符编码未被客户端（尤其是 Microsoft Excel）正确识别所致。核心原因有三：
- 缺少 UTF-8 BOM（Byte Order Mark）头，导致 Excel 默认按 ANSI（如 GBK）解析 UTF-8 字节流；
-
Content-Type响应头格式错误（charset:UTF-8应为charset=UTF-8）； -
Content-Encoding: UTF-8是无效头（UTF-8 不是压缩编码，不应使用此头）。
✅ 正确做法如下：
✅ 1. 修正 HTTP 响应头
// ❌ 错误示例（已移除）
// header("Content-Encoding: UTF-8"); // 删除！UTF-8 不是编码方式
// header('Content-type: application/csv;charset:UTF-8'); // 格式错误
// ✅ 正确写法
header('Content-Type: text/csv; charset=UTF-8');
header('Content-Disposition: attachment; filename="' . $getrow["title"] . '_' . $_POST["year"] . '.csv"');
header('Cache-Control: no-cache');
header('Pragma: no-cache');⚠️ 注意：
Content-Type中charset=UTF-8必须紧随 MIME 类型后，且使用等号=，不能用冒号:；application/csv并非标准 MIME 类型，推荐使用更通用的text/csv。
QuickBooks Mileage CSV下载使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
✅ 2. 强制写入 UTF-8 BOM（关键步骤）
BOM（0xEF 0xBB 0xBF）是 Excel 识别 UTF-8 文件的“信号”。必须在写入任何 CSV 数据前，立即写入 BOM 到输出流：
立即学习“PHP免费学习笔记（深入）”；
$file = fopen('php://output', 'w');
// ✅ 写入 UTF-8 BOM（三字节签名）
fwrite($file, "\xEF\xBB\xBF");
// 或等价写法：fprintf($file, chr(0xEF) . chr(0xBB) . chr(0xBF));
// 后续写入数据（确保所有字段均为 UTF-8 编码）
foreach ($newname as $line) {
fputcsv($file, $line); // fputcsv 自动处理字段转义，但要求输入为 UTF-8 字符串
}
fclose($file);✅ 3. 额外保障：确保数据源为 UTF-8
- 数据库连接需设为 UTF-8（MySQLi 示例）：
mysqli_set_charset($db, 'utf8mb4'); // 推荐 utf8mb4（支持 emoji 及完整 Unicode）
- 若从 POST/GET 获取中文参数，确认页面提交编码为 UTF-8（HTML 表单
<meta charset="UTF-8">+accept-charset="UTF-8"）。
? 完整安全示例（含防注入与编码清理）
// 1. 清洗并验证输入（防止 SQL 注入）
$code = (int)$_POST["code"];
$year = preg_replace('/[^0-9\-]/', '', $_POST["year"]);
// 2. 查询数据（使用预处理更佳）
$a = mysqli_query($db, "SELECT * FROM remark_type WHERE remark_code = $code");
$getrow = mysqli_fetch_array($a);
if (!$getrow) die('Invalid code');
// 3. 设置响应头
header('Content-Type: text/csv; charset=UTF-8');
header('Content-Disposition: attachment; filename="' .
rawurlencode($getrow["title"]) . '_' . $year . '.csv"');
header('Cache-Control: no-cache');
header('Pragma: no-cache');
// 4. 输出 BOM + CSV 数据
$file = fopen('php://output', 'w');
fwrite($file, "\xEF\xBB\xBF");
// 确保 $newname 中每个字符串都是 UTF-8 编码（必要时转换）
foreach ($newname as $line) {
// 如需强制转码（例如数据来自 GBK 源）：
// $line = array_map(fn($v) => mb_convert_encoding($v, 'UTF-8', 'GBK'), $line);
fputcsv($file, $line);
}
fclose($file);
exit;? 常见误区总结
| 问题 | 说明 |
|---|---|
echo "\xEF\xBB\xBF"; 在 fopen('php://output') 之前 |
无效！BOM 必须写入到 fopen 打开的流中，否则可能被缓冲或截断 |
使用 application/csv MIME 类型 |
非标准，部分浏览器/Excel 版本兼容性差，优先用 text/csv
|
| 未设置数据库连接编码 | 即使 PHP 文件是 UTF-8，若 MySQL 返回 GBK 字节，仍会乱码 |
在 fputcsv 前手动 echo 其他内容 |
会破坏 CSV 结构，BOM 必须是文件开头唯一内容 |
遵循以上步骤，即可稳定导出 Excel 可直接双击打开、中文清晰显示的 CSV 文件。记住：BOM 是 Excel 的“钥匙”，正确的 Content-Type 是“说明书”，而数据库与 PHP 的 UTF-8 一致性才是根基。
