ThinkPHP导出多语言Excel表头需完整编码链路：设SimSun等中文字体、HTTP响应头含charset=utf-8并rawurlencode文件名、Lang文件用UTF-8无BOM保存、表头清洗不可见字符、日期写入DateTime对象再设NumberFormat格式码。
ThinkPHP 导出多语言 Excel 表头，核心不是框架本身多语言机制，而是 PhpSpreadsheet 对 UTF-8 字符、字体、单元格编码的显式控制 —— 漏掉任一环，中文/日文/繁体等就会变方块或乱码。
表头写入前必须设中文字体（SimSun 或 Microsoft YaHei）
PhpSpreadsheet 默认用 Calibri，不支持中文渲染。即使 PHP 输出的是 UTF-8、数据库字段是 utf8mb4，Excel 打开后仍显示“□□□”。
必须在创建 Spreadsheet 实例后立即设置全局默认字体：
$spreadsheet = new Spreadsheet();
$spreadsheet->getDefaultStyle()->getFont()->setName('SimSun'); // Windows 简体中文
// 或 $spreadsheet->getDefaultStyle()->getFont()->setName('Microsoft YaHei');
别只给 A1 单元格单独设字体，否则表头以外的中文内容（如数据行里的日文名、越南文地址）依然会乱码。
HTTP 响应头 charset=utf-8 不能省，且文件名需 rawurlencode()
浏览器靠响应头识别 Excel 文件编码。漏掉 charset=utf-8，部分旧版 Excel（尤其是 macOS 的 Numbers）会按 Latin-1 解析，中文直接变问号或空格。
关键三行响应头必须齐全：
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet; charset=utf-8');header('Content-Disposition: attachment; filename="'.rawurlencode('用户报表_日本語.xlsx').'";');header('Cache-Control: max-age=0');
注意：rawurlencode() 是必须的 —— 直接拼接中文文件名，在 Chrome/Firefox 下可能触发下载失败或文件名截断。
多语言表头字段来自 Lang 文件时，别用 __() 包裹后直接传给 setCellValue()
ThinkPHP 的 __() 函数返回的是字符串，没问题；但如果你的多语言配置里混用了 HTML 实体（如 ）、ANSI 转义符或 BOM 头，setCellValue() 会原样写入 Excel，导致列宽异常或 Excel 报“文件已损坏”。
安全做法是：导出前对表头数组做清洗：
$header = [
['key' => 'name', 'title' => __('姓名')],
['key' => 'name_ja', 'title' => __('氏名')],
['key' => 'name_zh_tw', 'title' => __('姓名（繁體）')],
];
// 清洗：去除不可见字符、转义符、多余空格
$header = array_map(function($h) {
$h['title'] = trim(html_entity_decode(strip_tags($h['title']), ENT_QUOTES, 'UTF-8'));
return $h;
}, $header);
尤其注意：Lang 文件若用记事本保存过，可能带 BOM；建议用 VS Code 或 PhpStorm 以 UTF-8 without BOM 编码保存语言文件。
日期/数字字段含多语言格式时，别用 format() 转字符串再写入
比如你导出含日语本地化日期的表头：“登録日（YYYY年MM月DD日）”，这没问题；但若把数据库的 created_at 字段用 $user->created_at->format('Y年m月d日') 写入单元格，Excel 就当纯文本处理 —— 后续无法排序、筛选、求和。
正确做法分两步：
- 用
setCellValue()写入原始时间戳或 DateTime 对象（PhpSpreadsheet 自动识别为日期类型） - 再用
getStyle()->getNumberFormat()->setFormatCode()设置显示格式：
$cell = 'C2';
$sheet->setCellValue($cell, $user->created_at); // 传 DateTime 实例
$sheet->getStyle($cell)->getNumberFormat()->setFormatCode('yyyy"年"mm"月"dd"日"');
这个格式码在 Excel 中会正确显示为「2026年04月18日」，且保留数值属性。简体中文、日文、繁体环境都兼容 —— 因为格式码本身是 Excel 内置语法，不依赖系统区域设置。
最容易被忽略的是：多语言 Excel 不是“翻译完字段就完事”，而是一整套编码链路 —— 从 Lang 文件编码、PHP 字符串处理、PhpSpreadsheet 字体绑定、HTTP 头声明，到 Excel 单元格格式码，缺一不可。任意一环断掉，轻则显示异常，重则文件打不开。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
