phpexcel xls乱码处理方法：用phpexcel导出到xls文件时出现乱码怎么解决

PHPExcel导出XLS乱码？3分钟搞定编码问题！

场景重现：令人抓狂的乱码时刻

"小王啊，客户要的销售报表做好了吗？"经理第3次来催了。

"马上好！"你擦了擦汗，按下最后一行PHPExcel导出代码，文件生成成功，双击打开——"鍝堝搱鍝堝搱鍝堝搱..."满屏都是这种火星文！你瞬间血压飙升，明明本地测试好好的，怎么到服务器上就变成这样了？

别慌！这其实是PHPExcel导出XLS时常见的编码问题，今天我就手把手教你彻底解决这个烦人的乱码问题。

乱码根源大起底

1 为什么会出现乱码？

乱码的本质是编码不一致,PHPExcel在生成XLS文件时，默认使用UTF-8编码，但老版本的Excel（特别是2003及以下版本）更习惯处理GBK或GB2312编码的中文内容，当编码不匹配时，就会出现我们看到的"天书"。

2 常见乱码场景

• 服务器环境与本地环境编码设置不同
• Excel版本较老（2003及以下）中包含特殊符号或emoji表情
• 文件头信息缺失或不正确

5种实测有效的解决方案

1 方法一：强制设置输出编码（推荐）

// 在导出代码前加入这些设置
$objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel5');
header('Content-Type: application/vnd.ms-excel; charset=GBK');  // 关键在这里
header('Content-Disposition: attachment;filename="销售报表.xls"');
header('Cache-Control: max-age=0');
$objWriter->save('php://output');
exit;

效果：适用于90%的中文乱码场景，简单粗暴有效

2 方法二：转换单元格编码

如果只有部分单元格乱码,可以单独处理：

// 假设$sheet是你的工作表对象
$value = iconv('UTF-8', 'GBK//IGNORE', $originalValue);
$sheet->setCellValue('A1', $value);

注意：//IGNORE参数会忽略无法转换的字符，防止报错

3 方法三：修改PHPExcel核心类（慎用）

找到PHPExcel的Writer/Excel5.php文件，约第300行附近：

// 修改前
$str = PHPExcel_Shared_String::UTF8toBIFF8UnicodeShort($this->getUTF8($pValue));
// 修改后
$str = $this->getUTF8(iconv('UTF-8', 'GBK', $pValue));

警告：这会修改框架核心，升级PHPExcel时可能被覆盖

4 方法四：输出CSV临时方案

如果时间紧迫,可以先导出CSV应急：

header('Content-Type: text/csv; charset=GBK');
header('Content-Disposition: attachment;filename="数据备份.csv"');
$fp = fopen('php://output', 'w');
fwrite($fp, chr(0xEF).chr(0xBB).chr(0xBF)); // BOM头
// 写入数据...

5 方法五：终极BOM大法

在输出前添加BOM头：

echo chr(0xEF).chr(0xBB).chr(0xBF); // UTF-8 BOM
$objWriter->save('php://output');

防乱码最佳实践

1. 环境检查清单：

   • 确认PHP文件本身保存为UTF-8无BOM格式
   • 检查服务器是否安装了中文字体
   • 测试不同Excel版本的兼容性

2. 代码规范建议：

   // 好的习惯
   $excel->setActiveSheetIndex(0)
         ->setCellValue('A1', iconv('UTF-8', 'GBK', '订单号'))
         ->setCellValue('B1', iconv('UTF-8', 'GBK', '金额'));
   // 不好的习惯
   $excel->getActiveSheet()->setCellValue('A1', '订单号');

3. 调试技巧：

   

   • 先用记事本打开导出的XLS文件,看原始数据是否正常
   • 在Linux服务器上用file -i 文件名.xls查看实际编码
   • 记录导出时的内存使用情况,大数据量时可能因内存不足导致编码异常

常见问题QA

Q：为什么设置了GBK还是乱码？ A：可能是数据源本身编码混乱，尝试先用mb_detect_encoding()检测实际编码

Q：Mac系统下也适用这些方法吗？ A：Mac版Excel对编码更宽容，但建议仍保持GBK统一

Q：导出PDF会不会有乱码问题？ A：PDF导出需要确保服务器安装了中文字体，是另一个技术点了

Q：PHPExcel已经停止维护了，新项目怎么办？ A：可以考虑PhpSpreadsheet（PHPExcel的继任者），但乱码处理方法类似

写在最后

记得上周解决这个问题后,小王准时交上了报表，经理打开文件时眼前一亮："这次格式很标准嘛！" 你深藏功与名，默默收下了这组经过实战检验的代码片段。

编码问题就像办公室里的隐藏彩蛋,找到诀窍后其实很简单，收藏这篇文章，下次再遇到乱码，3分钟内就能搞定啦！