PHP生成CSV文件时写入前置制表符问题咨询

这种在CSV文件开头莫名出现制表符的情况，我之前也踩过坑，大概率是脚本在发送header和输出CSV内容之前，已经有隐性的输出内容了，下面给你一步步排查和解决的方案：

可能的原因 #

• 你的PHP脚本（或者引入的其他文件）开头的<?php标签前，有空格、制表符或者换行符
• 某个被include/require的文件末尾，?>标签之后存在空白字符（空格、制表符、换行）
• 代码中存在提前输出的内容：比如调试用的echo/var_dump，或者PHP的Notice/Warning错误信息被输出到页面
• 少数情况是文件保存时带有UTF-8 BOM头（不过BOM是3个字符，和制表符不太一样，但也可以排查下）

排查与解决步骤 #

1. 检查文件首尾的空白字符 #

• 确保所有PHP文件的<?php标签前没有任何字符，包括空格、换行、HTML注释
• 建议去掉PHP文件末尾的?>标签（PHP会自动识别脚本结束），避免标签后的空白被意外输出

2. 启用输出缓冲控制 #

在脚本的最开头加上输出缓冲，清空所有提前输出的内容，这是快速解决隐性输出问题的有效方法：

<?php
// 开启输出缓冲
ob_start();

// ... 你的业务代码 ...

// 在发送header之前，清空所有缓冲内容
ob_clean();

3. 修正你的CSV生成代码 #

下面是调整后的完整代码，同时还修复了表头和数据键不匹配的小问题（表头是E-Mail，原数据里是EMail，会导致对应列空值）：

<?php
ob_start();

$cabecalho = array( "RazaoSocial", "NomeFantasia", "Nome", "CNPJ", "CPF", "Telefone", "E-Mail" );
$cliente = array( 
    "RazaoSocial" => "1", 
    "NomeFantasia" => "2", 
    "Nome" => "3", 
    "CNPJ" => "4", 
    "CPF" => "5", 
    "Telefone" => "6", 
    "E-Mail" => "7" // 统一键名和表头一致
);
$clientes[] = $cliente;

$filename = sprintf('lala_%s.csv', date('Y-m-d H-i'));

// 清空缓冲，确保没有提前输出的内容干扰
ob_clean();

// 设置完整的CSV响应头
header("Cache-Control: must-revalidate, post-check=0, pre-check=0");
header("Content-Type: text/csv; charset=utf-8");
header("Content-Disposition: attachment; filename=\"{$filename}\"");
header("Pragma: no-cache");
header("Expires: 0");

// 使用fputcsv生成标准CSV，避免手动拼接的格式错误
$output = fopen('php://output', 'w');
fputcsv($output, $cabecalho, ';', '"');

foreach ($clientes as $row) {
    fputcsv($output, $row, ';', '"');
}

fclose($output);
exit;
?>

4. 额外注意事项 #

• 优先用fputcsv代替手动拼接字符串：它会自动处理包含逗号、引号的内容，保证CSV格式符合标准
• 统一表头和数据的键名：避免出现列值错位、空值的情况
• 临时关闭错误输出到页面：如果有Notice级别的错误，也会提前输出内容，可以临时加上error_reporting(0);测试，之后再排查错误根源

内容的提问来源于stack exchange，提问作者Bruno Luiz K.