PHP写入CSV时如何保留单个单元格内的换行符？

问题根源 #

• 换行符类型错误：Excel这类主流CSV阅读器只识别Windows风格的\r\n作为单元格内换行，单独使用\n会被解析成新的一行。
• 转义规则不符规范：CSV标准中，字段内的双引号需要转义为两个连续双引号("")，而非用反斜杠转义；手动写\"会导致阅读器格式识别失败。
• 字段包裹不严谨：只要字段包含换行、逗号或双引号，必须全程用双引号包裹，漏包或半包都会破坏CSV整体结构。

正确解决方法 #

优先使用PHP内置fputcsv函数（推荐） #

该函数会自动处理所有CSV格式规则，无需手动拼接字符串，避免人为错误：

$chipIds = ['FirstChipID', 'SecondChipID', 'ThirdChipID'];
// 用\r\n拼接芯片ID，生成单元格内换行的字符串
$combinedIds = implode("\r\n", $chipIds);

$file = fopen('output.csv', 'w');
// fputcsv会自动给带换行的字段套双引号、转义特殊字符
fputcsv($file, ['产品名称', $combinedIds, '批次号']);
fclose($file);

手动拼接CSV字符串（不推荐，易出错） #

若必须手动实现，严格遵循CSV规范：

$chipIds = ['FirstChipID', 'SecondChipID', 'ThirdChipID'];
$combinedIds = implode("\r\n", $chipIds);
// 转义字段内的双引号（如果存在）
$combinedIds = str_replace('"', '""', $combinedIds);
// 用双引号包裹整个字段
$combinedIds = "\"$combinedIds\"";

// 拼接整行数据，字段用逗号分隔，行尾加\r\n
$row = "产品名称,$combinedIds,批次号\r\n";

file_put_contents('output.csv', $row);

验证提示 #

不要用普通文本编辑器查看结果，需用Excel、Numbers这类专业CSV阅读器，文本编辑器会直接显示\r\n为换行，但无法识别为单元格内的换行格式。

内容的提问来源于stack exchange，提问作者Harry You