开发杂记

Excel 打开 CSV 出现中文乱码的原因与终极解决方法（BOM 头的秘密）

1 min read

在前端导出表格数据、后端导出用户报表或下载 CSV 文件后，用记事本或 VS Code 打开中文显示完全正常，但只要使用 Microsoft Excel 双击打开，所有中文字符全部变成“锟斤拷”等火星乱码。本文解析其编码冲突机制并给出两端修复方案。

一、 核心根因：Excel 对 UTF-8 编码的嗅探缺陷

现代 Web 系统默认采用标准的 UTF-8（无 BOM） 编码输出文本文件。然而，Windows 版 Microsoft Excel 默认使用系统的本地 ANSI/GBK 编码解析 CSV 文件，除非在文件开头明确检测到 UTF-8 BOM 头（0xEF, 0xBB, 0xBF）。

二、 开发者端修复：在导出 CSV 时注入 UTF-8 BOM 头

1. JavaScript 前端导出修复：

const csvContent = "姓名,部门,职位\n张三,技术部,架构师\n";
// 在 Blob 开头注入 \uFEFF BOM 字节标记
const blob = new Blob(["\uFEFF" + csvContent], { type: "text/csv;charset=utf-8;" });
const url = URL.createObjectURL(blob);
// 创建下载链接即可在 Excel 中完美显示中文

2. PHP / Node.js 后端导出修复：

// PHP 输出 CSV 前写入 BOM 头
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="report.csv"');
echo "\xEF\xBB\xBF"; // 注入 3 字节 UTF-8 BOM

三、 用户端临时手动查看方法

  1. 新建一个空白 Excel 工作簿；
  2. 点击顶部菜单 数据 (Data) -> 自文本/CSV (From Text/CSV)；
  3. 选择乱码的 CSV 文件，在预览界面的“文件原始格式（File Origin）”下拉框中选择 65001 : Unicode (UTF-8)；
  4. 点击“加载”，数据即可恢复清晰中文。
#开发杂记