fputcsv可直接写二维数组到CSV文件，每子数组为一行，自动处理转义与引号；子数组值须为标量，禁用implode拼接，PHP 8.1+可用str_putcsv安全生成单行。
用 fputcsv 直接写二维数组到 CSV 文件，不手动降维
PHP 本身不需要把二维数组“先转成一维再写入 CSV”——fputcsv 就是专为这种场景设计的。它自动把每个子数组当作 CSV 的一行，逐字段处理转义、引号包裹和分隔符拼接。
常见错误是先用 array_merge(...$arr) 或循环 array_values() 拼成一维，结果把多行数据压扁成单行，完全破坏 CSV 结构。
- ✅ 正确做法：打开文件句柄后，对每个子数组调用
fputcsv($fp, $row) - ⚠️ 注意：子数组里的值必须是标量（字符串/数字），不能含嵌套数组或对象，否则会报 Warning 并输出
Array字符串 - ? 如果某列要强制加双引号（比如含换行符或逗号），直接传字符串即可，
fputcsv会自动处理
手动拼接 CSV 行时，别用 implode 简单连接
如果因特殊需求必须自己构造 CSV 字符串（例如写入内存而非文件），不能直接 implode(',', $row) —— 这会跳过所有 CSV 规则校验，导致含逗号、换行、双引号的字段解析失败。
PHP 提供了 str_putcsv（PHP 8.1+）或兼容方案：
立即学习“PHP免费学习笔记（深入）”；
- PHP ≥ 8.1：用
str_putcsv($row)返回已转义的单行字符串 - PHP fputcsv，再读取内容：
$fp = fopen('php://memory', 'r+b');
fputcsv($fp, $row);
rewind($fp);
$line = stream_get_contents($fp);
fclose($fp); - ❌ 避免手写正则替换或简单加引号——CSV 转义规则比想象中复杂（如双引号要变成两个双引号）
导出中文字段时，BOM 头必须加在文件开头，且只加一次
Excel 打开 UTF-8 CSV 显示乱码，本质是缺 UTF-8 BOM（\xEF\xBB\xBF）。但这个头只能出现在整个文件最开始，不能每行都加。
- ✅ 正确：打开文件后立即
fwrite($fp, "\xEF\xBB\xBF")，再循环写入各行 - ❌ 错误：在每次
fputcsv前都写 BOM，会导致 Excel 只认第一行，后续全乱码 - ? 如果用
php://output输出下载，也要确保 header 在 write BOM 之前发送，且无任何输出前置
性能敏感场景下，避免频繁 fputcsv 调用
写入上万行时，每行一次 fputcsv 会产生较多系统调用开销。可批量缓冲后再写入：
- 用
ob_start()+ob_get_clean()暂存多行字符串，再一次性fwrite - 或使用
stream_filter_append($fp, 'convert.iconv.UTF-8/UTF-16LE')等过滤器预处理（较少用） - ⚠️ 注意：缓冲区大小需权衡内存占用与 I/O 效率，一般 1000 行左右较稳妥
真正容易被忽略的是字段内容里的 null 字节（\0）——它会让 fputcsv 截断输出，且无任何警告。导出前最好用 str_replace("\0", "", $value) 清洗。
