PHP生成的Excel文件无法在Microsoft Excel中打开如何解决？

根因说明 #

你当前编写的代码输出的是制表符分隔的纯文本内容，并不是标准的XLSX二进制格式，同时设置的响应头、文件后缀和实际输出的文件格式不匹配，因此Excel会抛出格式错误。 #

解决方案 #

方案1：最小改动适配现有代码（适合简单场景） #

不需要修改现有输出逻辑，只要调整响应头、文件后缀并补充兼容处理即可：

• 修正响应头与文件后缀，和实际输出格式匹配
• 输出内容前添加UTF-8 BOM头，避免中文乱码
• 可选择将分隔符替换为逗号，生成通用性更强的CSV格式
  修改后的代码示例：

// 输出UTF-8 BOM头，解决中文乱码问题
echo "\xEF\xBB\xBF";
// 修正Content-Type为制表符分隔文本对应的类型
header('Content-Type: text/tab-separated-values');
// 把文件后缀改为tsv，和格式匹配，也可以改为csv，对应把分隔符换成逗号
$fileName = 'test.tsv';
header('Content-Disposition: attachment; filename='.$fileName);

echo implode("\t", array_values($heading)) . "\n";

while( $row = mysqli_fetch_array($result)) {
        $record=array();
        $record[]=$row["join_date"];
        $record[]=$agents[$row["agent_id"]];
        $record[]=$row["name"];
        $record[]=$row["amount"];
        $record[]=$brokerages[$row["brokerage"]];
        // 如果内容里包含制表符、换行符，需要先转义再输出，避免单元格错乱
        echo implode("\t", array_values($record)) . "\n";
}
exit;

方案2：生成标准XLSX格式（兼容性最好，无格式警告） #

如果需要生成标准的XLSX文件，推荐使用成熟的PHP库PhpSpreadsheet处理，无需手动实现XLSX格式逻辑，避免兼容问题。
简单实现示例：

// 先通过composer安装依赖：composer require phpoffice/phpspreadsheet
require 'vendor/autoload.php';

use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;

$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();

// 写入表头
$colIndex = 1;
foreach (array_values($heading) as $headVal) {
    $sheet->setCellValueByColumnAndRow($colIndex, 1, $headVal);
    $colIndex++;
}

// 写入数据行
$rowIndex = 2;
while( $row = mysqli_fetch_array($result)) {
    $colIndex = 1;
    $record = [
        $row["join_date"],
        $agents[$row["agent_id"]],
        $row["name"],
        $row["amount"],
        $brokerages[$row["brokerage"]]
    ];
    foreach ($record as $cellVal) {
        $sheet->setCellValueByColumnAndRow($colIndex, $rowIndex, $cellVal);
        $colIndex++;
    }
    $rowIndex++;
}

// 输出下载响应头
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment;filename="test.xlsx"');
header('Cache-Control: max-age=0');

$writer = new Xlsx($spreadsheet);
$writer->save('php://output');
exit;

注意事项 #

• 输出文件内容前不能有任何额外输出，包括PHP报错信息、代码前后的空白字符、其他echo输出，否则会破坏文件结构导致无法打开
• 输出完成后要及时执行exit终止程序，避免后续代码输出额外内容污染文件

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