fputcsv导出CSV乱码或错列的根本原因是未正确处理UTF-8 BOM、escape参数及换行符：必须写入BOM头（）使Excel识别UTF-8，PHP 7.4中escape参数须显式设为空字符串''以兼容RFC 4180，且含 或"的字段需预处理或依赖fputcsv自动包裹转义。
fputcsv 在 PHP 7.4 中能直接写入 CSV，但默认行为在换行、转义、编码上容易出错——尤其当字段含
、"、, 或中文时，不加干预大概率生成损坏文件或解析失败。
为什么 fputcsv 写出来的 CSV 打开是乱码或错列
根本原因不是函数本身，而是没控制好三件事：文件编码、字段封装逻辑、换行符处理。
- PHP 脚本默认用 UTF-8 编码，但 Excel（尤其是 Windows 版）打开 CSV 时默认按 ANSI（如 GBK）解析，导致中文显示为乱码；必须在文件开头写入 BOM 头
，Excel 才会识别为 UTF-8 -
fputcsv默认用双引号"包裹字段，但若字段本身含双引号或换行符，它会自动转义（比如"a""b"），而某些旧版 Excel 或非标准 CSV 解析器无法正确还原 - Windows 系统下用户输入的
fputcsv，会被当成新行起点，导致 CSV 行数错乱（一个字段被拆成多行）
fputcsv 的 escape 参数在 PHP 7.4 必须显式设为空字符串
PHP 7.4 仍支持 escape 默认值 "\"，但该行为已不兼容 RFC 4180，且会导致往返读写失真（fgetcsv 读不出原样）。从 PHP 8.4 起已被弃用，PHP 7.4 项目现在就得改。
- 错误写法：
fputcsv($fp, $row, ',', '"')—— 没传escape，用默认"\"，字段里出现cd会被写成"cd"，再读回来变成c+d（截断） - 正确写法：
fputcsv($fp, $row, ',', '"', '')—— 第 5 个参数传空字符串''，彻底禁用转义，只靠双引号包裹和重复引号来处理内部引号（如"a""b"） - 注意：第 5 个参数是
escape，不是第 6 个；PHP 7.4 不支持命名参数，必须按位置填满前 5 个才能控制escape
写入含换行符的 textarea 字段要预处理
fputcsv 不会帮你“折叠”字段内的
，它只负责按 CSV 规则包裹和分隔。若用户在表单中输入带换行的备注，直接写入会导致 CSV 结构崩溃。
QuickBooks Mileage CSV
下载
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
立即学习“PHP免费学习笔记（深入）”；
- 不要用
str_replace([" ", " ", " "], ' ', $text)简单替换为空格——会丢失格式语义 - 推荐统一转为
str_replace(" ", "<br>", $text)，这样 Excel 打开虽不渲染<br>
，但至少整字段保留在一列；导出给网页展示时可直接用 - 更健壮的做法：对每个字段做预处理，仅对含
"的字段启用包裹，其余字段不强制引号（fputcsv内部会自动判断是否需要引号） - 示例片段：
$row = array_map(function($v) { if (is_string($v) && (strpos($v, " ") !== false || strpos($v, '"') !== false)) { return str_replace([" ", " "], " ", $v); } return $v; }, $row); fputcsv($fp, $row, ',', '"', ''); // 显式禁用 escape
大文件导出别用内存拼接，直接流式写入
导出 10 万行数据时，如果先 implode 成一个大字符串再 fwrite，PHP 内存会暴涨甚至 OOM。PHP 7.4 完全支持边查边写。
- 数据库查询用
PDO::FETCH_ASSOC配合yield或分批fetch()，每次只持有一行数据 - 打开文件用
fopen('php://output', 'w')直接输出到响应体，配合header强制下载，避免临时文件 - 务必在
fopen后立即写入 BOM：fwrite($fp, "");，否则 UTF-8 中文在 Excel 里还是乱码 - 每写一行检查返回值：
if (fputcsv($fp, $row, ',', '"', '') === false) { die('CSV write failed'); }，避免静默失败
最易被忽略的是 BOM 头和 escape 参数——前者决定 Excel 能不能认出 UTF-8，后者决定字段里的反斜杠和引号会不会被二次污染。这两个点不处理，其他优化都白搭。
