PHP中使用fwrite写入number_format格式化数值到CSV显示异常如何解决

问题原因 #

CSV默认以逗号作为列分隔符，number_format()生成的格式化数值自带千位分隔逗号，会被CSV解析器识别为列拆分标记，导致数值被拆分到多个单元格。

修复方案 #

方案1：使用PHP内置fputcsv()函数（推荐） #

fputcsv()会自动处理包含特殊字符（逗号、双引号、换行符）的字段，自动添加双引号包裹、转义特殊字符，无需手动处理分隔逻辑，兼容性最好。
修复后完整代码：

header('Content-Type: text/csv; charset=utf-8');  
header("Cache-Control: max-age=0, no-cache, must-revalidate, proxy-revalidate");
header('Content-Disposition: attachment; filename=' . $fileName ); 
header("Content-Transfer-Encoding: binary");
header('Pragma: no-cache');
header('Expires: 0');

// 直接输出到下载流，无需写入服务器本地文件
$file = fopen("php://output", "w");  
// 输出UTF-8 BOM，解决Excel打开CSV中文乱码问题
fwrite($file, chr(0xEF).chr(0xBB).chr(0xBF));

fputcsv($file, ["Generate Report"]);
fputcsv($file, ["Total Sales", number_format($total)]);
fputcsv($file, [" "]);

fclose($file);
exit;

方案2：手动包裹双引号（适配原有fwrite写法） #

如果不想修改原有fwrite的写入逻辑，可以给包含逗号的字段外层手动包裹双引号，CSV会将双引号包裹的内容识别为单个单元格。
修改对应行代码即可：

fwrite($file, "Total Sales, \"".number_format($total)."\"\r\n");

注意：如果字段本身包含双引号，需要手动将双引号转义为两个连续双引号，否则仍会出现解析异常，因此优先推荐使用fputcsv()方案。

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