根本原因是绘图库未加载支持中文的字体文件或未正确设置字体路径和编码:GD需传入含中文的.ttf路径,PhpSpreadsheet需设置中文字体名,Chart.js需前端配置可访问的中文字体族。

PHP 生成统计图表(如用 GD 或 PHPExcel/PhpSpreadsheet、Chart.js 配合后端数据)出现中文乱码,根本原因不是 PHP 文件编码错了,而是绘图库没加载支持中文的字体文件,或没正确设置字体路径和编码。
GD 图像函数(imagefttext 等)显示中文乱码
GD 默认不带中文字体,imagefttext 必须显式传入一个 .ttf 字体文件路径,且该字体必须包含中文字符集(如 simhei.ttf、NotoSansCJKsc-Regular.otf)。
- 确认字体文件真实存在且 Web 服务器有读取权限(建议放项目内,如
./fonts/simhei.ttf) - 不要用系统字体路径(如
C:\Windows\Fonts\...),Linux 服务器通常没有 Windows 字体 - 调用
imagefttext时第 7 个参数必须是绝对或相对于当前脚本的字体路径:imagefttext($img, 14, 0, 50, 50, $color, './fonts/simhei.ttf', '测试中文') - 确保 PHP 文件本身是 UTF-8 无 BOM 编码,但重点不在这里——GD 不解析 PHP 文件编码,只认传入的字符串字节流和字体是否覆盖这些字形
PhpSpreadsheet 导出 Excel 图表中文乱码
PhpSpreadsheet 本身支持 UTF-8,但图表标题、坐标轴文字乱码,是因为它默认用 Calibri(西文字体),不兼容中文。需手动设置字体:
- 对图表对象调用
setTitleFont、setXAxisFont、setYAxisFont等方法 - 字体名要写系统/容器里实际存在的中文字体名(非文件名),常见可靠写法:
['name' => 'SimHei', 'size' => 10]或['name' => 'Microsoft YaHei', 'size' => 10] - Docker 环境需额外安装中文字体包(如 Debian 系:安装
fonts-wqy-zenhei并刷新 fontconfig) - 如果导出后仍乱码,检查 Excel 打开时是否提示“字体替换”,说明目标机器缺对应字体——此时应改用更通用的开源字体如
Noto Sans CJK SC
Chart.js 前端图表中文乱码(后端 PHP 提供 JSON 数据)
这其实不是 PHP 的问题,而是前端 Canvas 渲染时字体缺失。PHP 只负责输出 UTF-8 JSON,乱码发生在浏览器绘图阶段:
立即学习“PHP免费学习笔记(深入)”;
- 确保 Chart.js 配置中显式指定字体:
options.plugins.title.font.family = 'PingFang SC, Microsoft YaHei, sans-serif' - 避免只写
'SimSun'这类老字体,iOS/macOS 不支持;优先用多层 fallback - 若用 CDN 加载 Chart.js,确认未被拦截导致字体 CSS 未生效;可本地托管字体或用
@font-face预加载 - PHP 接口返回的 JSON 中文正常(可用
curl -v或浏览器直接访问验证),就不用动 PHP header 或 mb_internal_encoding
真正容易被忽略的是:字体文件路径是否可被 Web 服务器访问(GD)、字体名是否在目标环境注册(PhpSpreadsheet)、以及前端是否真的能下载并应用该字体(Chart.js)。这三个环节任一断掉,都会表现为“PHP 设置了却还是乱码”。











