使用 fputcsv 保存 CSV 文件时，如何控制文件编码格式避免乱码问题？

M66 2025-06-22

1. fputcsv 函数简介

PHP 中的 fputcsv 函数用于将一个数组数据写入到 CSV 文件中，它是处理 CSV 文件生成和写入的常用函数。fputcsv 的基本语法如下：

fputcsv($file, $fields, $delimiter = ',', $enclosure = '"', $escape_char = '\\');

其中，参数 $file 是文件句柄，$fields 是要写入的数组，$delimiter 是分隔符，默认是逗号，$enclosure 是围绕字段的字符，默认为双引号，$escape_char 是转义字符。

2. 常见乱码问题

当我们在多种操作系统（如 Windows 和 Linux）中打开 CSV 文件时，可能会遇到乱码问题。这是由于不同操作系统和应用程序使用的默认字符编码不一致导致的。例如，Windows 默认使用 GBK 或者 Windows-1252 编码，而 Linux 和 macOS 更常用 UTF-8 编码。

3. 控制编码格式的策略

3.1 使用 mb_convert_encoding 转换编码

为了确保文件在不同环境中都能够正确显示，我们可以在使用 fputcsv 写入数据之前，使用 mb_convert_encoding 函数将数据编码转换为统一的编码格式，通常推荐使用 UTF-8 编码。

// 假设数据是中文
$data = ['姓名', '年龄', '城市'];
$data = array_map(function($value) {
    return mb_convert_encoding($value, 'UTF-8', 'auto'); // 自动识别并转换为 UTF-8
}, $data);

$file = fopen('output.csv', 'w');
fputcsv($file, $data);
fclose($file);

这种方法确保了 CSV 文件中每一列的内容都采用 UTF-8 编码，从而避免了乱码问题。

3.2 设置 BOM 头以支持 UTF-8 编码

UTF-8 编码的文件有时会被某些程序（如 Excel）错误地识别为 ANSI 编码。为了解决这个问题，可以在文件的开头添加 UTF-8 的 BOM（字节顺序标记）。这样可以确保文件在 Excel 中正确显示。

$file = fopen('output.csv', 'w');

// 添加 BOM 头
fwrite($file, "\xEF\xBB\xBF");

$data = ['姓名', '年龄', '城市'];
fputcsv($file, $data);

fclose($file);

3.3 修改 Excel 的默认编码

在某些情况下，我们可以直接设置 Excel 打开 CSV 文件时的编码方式。虽然这种方法不一定适用所有场景，但它是解决乱码问题的一个备选方案。可以通过在 CSV 文件的 URL 中指定编码格式来实现：

$fileUrl = 'http://m66.net/downloads/csv/output.csv';

当然，这种方法适用于文件以 URL 形式直接下载时，用户在下载过程中指定了编码方式。

3.4 强制输出为特定编码格式

有时候，我们需要将 CSV 文件导出为指定的编码格式（如 GBK）。可以在写入之前将每一行的数据通过 mb_convert_encoding 转换为目标编码格式。

$data = ['姓名', '年龄', '城市'];
$data = array_map(function($value) {
    return mb_convert_encoding($value, 'GBK', 'UTF-8'); // 将 UTF-8 转为 GBK
}, $data);

$file = fopen('output.csv', 'w');
fputcsv($file, $data);
fclose($file);

这种方式适合在中国地区的 Windows 系统中使用，防止因 Excel 默认使用 GBK 编码而导致的乱码。

4. 总结

在使用 PHP 的 fputcsv 函数时，遇到编码问题是一个常见的挑战。通过控制文件编码格式，确保文件在不同系统和应用程序中正确显示，避免乱码，可以使用以下几种方法：

使用 mb_convert_encoding 将数据转换为统一的编码格式。
添加 UTF-8 BOM 头，以确保 Excel 正确识别 UTF-8 编码。
根据需要选择不同的字符编码，如 GBK，来适配不同的操作系统。
在 URL 中直接指定编码方式（例如 m66.net）来规避部分兼容性问题。

通过这些技巧，可以在导出 CSV 文件时避免乱码问题，提升用户体验。