Python Matplotlib绘图中文显示方框或乱码的快速修复代码

山海之间
山海之间
发布时间:2026-11-22| 6人浏览过
原创

针对Python使用Matplotlib绘图时中文标题、坐标轴标签显示为方框(ToFu)或乱码的问题,提供立竿见影的两行核心修复代码,深入剖析字形缺失与负号编码成因,并给出跨平台兼容配置与缓存排查方案。

在 Python 中使用 Matplotlib 绘制图表时,中文标题或标签往往会退化为方框(ToFu 符号)并抛出 Glyph ... missing from font(s) 告警,负数坐标轴有时也会变成方块。最直接的解决方式是在导入 matplotlib.pyplot 之后,注入中文字体并关闭 Unicode 负号转义。

1. 核心修复代码与即刻生效方案

在所有绘图代码执行前,只需加入以下两行全局配置参数,即可彻底消除图表中的中文小方框和坐标轴负号异常:

import matplotlib.pyplot as plt

# 1. 设置无衬线字体优先级,首选系统自带中文字体
plt.rcParams['font.sans-serif'] = ['SimHei', 'Microsoft YaHei', 'PingFang SC', 'Noto Sans CJK SC']

# 2. 正常显示负号(避免减号被替换成方块)
plt.rcParams['axes.unicode_minus'] = False

这一段代码的作用非常直观:第一行告诉 Matplotlib 在渲染文字时优先检索包含中文字形的字体族;第二行指示 Matplotlib 使用普通的 ASCII 减号(-)而非 Unicode 负号编码(U+2212),确保图表在负值区间不会出现缺失符号的方块。

Python Matplotlib绘图中文显示方框或乱码的快速修复代码
图 1:Matplotlib 默认环境下的字符回退与方框异常生成流程

2. 完整可执行验证脚本

为了直观对比配置生效后的效果,以下提供了一段包含负数坐标、中文标题及坐标轴图例文本的完整示例代码。你可以直接在本地 Python 环境中运行:

import matplotlib.pyplot as plt

# ----------------- 核心修复配置 -----------------
plt.rcParams['font.sans-serif'] = ['SimHei', 'Microsoft YaHei', 'PingFang SC', 'Arial Unicode MS']
plt.rcParams['axes.unicode_minus'] = False
# ------------------------------------------------

# 准备测试数据(包含正负数区间)
months = ['一月', '二月', '三月', '四月', '五月', '六月']
temperatures = [-5, -2, 4, 11, 18, 23]

# 创建图表并绘图
fig, ax = plt.subplots(figsize=(8, 4.5))
ax.plot(months, temperatures, marker='o', color='#17324D', linewidth=2, label='月均气温')

# 设置中文文本
ax.set_title('上半年各月份气温变化趋势', fontsize=14, pad=12)
ax.set_xlabel('统计月份', fontsize=11)
ax.set_ylabel('摄氏度 (℃)', fontsize=11)
ax.grid(True, linestyle='--', alpha=0.5)
ax.legend()

# 展示图形
plt.show()
Python Matplotlib绘图中文显示方框或乱码的快速修复代码
图 2:Matplotlib 中文配置与负号修正的四步操作流程

3. 跨操作系统字体选型矩阵

不同的操作系统默认内置的中文字体名称不一致。如果你的脚本需要在 Windows、macOS 和 Linux 环境中共享运行,建议在 font.sans-serif 中传入一个包含多平台候选名称的列表:

操作系统 推荐系统字体名称 替代可用字体 系统预装情况
Windows SimHei (中易黑体) Microsoft YaHei (微软雅黑) Windows 7/10/11 均默认预装
macOS PingFang SC (苹方-简) Arial Unicode MS, Heiti SC 现代 macOS 系统自带
Linux / 服务器 Noto Sans CJK SC (思源黑体) WenQuanYi Micro Hei (文泉驿微米黑) 云主机通常需手动通过 apt/yum 安装
Python Matplotlib绘图中文显示方框或乱码的快速修复代码
图 3:主流操作系统下的中文字体族匹配与回退次序

4. 常见异常排查与进阶修复策略

4.1 配置后仍然显示方块:清理字体缓存

在部分刚刚安装新字体或更新了 Matplotlib 版本的环境中,即使用户配置了正确的字体名称,Matplotlib 仍可能继续读取本地陈旧的缓存索引文件,导致新字体未被载入。

解决此问题的标准方法是清理 Matplotlib 的字体缓存文件。缓存文件通常位于用户主目录下的隐藏文件夹中:

  • Linux / macOS: ~/.cache/matplotlib/
  • Windows: C:\Users\<用户名>\.matplotlib\

你可以直接在终端中删除该缓存目录,或者在 Python 中执行以下命令打印实际缓存位置并手动清理:

import matplotlib
print("缓存目录位置:", matplotlib.get_cachedir())

删除缓存文件后重新运行绘图脚本,Matplotlib 会重新扫描系统中所有已安装字体并构建最新的字形索引列表。

4.2 不修改全局配置的局部指定方案 (FontProperties)

如果当前项目不允许修改全局 rcParams,或者只需在特定图表、特定子图或个别标签上使用中文,可以通过 fontproperties 参数进行针对性设置:

from matplotlib.font_manager import FontProperties
import matplotlib.pyplot as plt

# 方式 A:直接指定字体族名
font_cn = FontProperties(family='SimHei', size=12)

# 方式 B:直接指定本地 ttf/otf 字体文件的绝对路径
# font_cn = FontProperties(fname='/System/Library/Fonts/PingFang.ttc', size=12)

plt.plot([1, 2, 3], [4, 5, 6])
plt.title('局部字体设置标题', fontproperties=font_cn)
plt.xlabel('X轴中文说明', fontproperties=font_cn)
plt.show()
Python Matplotlib绘图中文显示方框或乱码的快速修复代码
图 4:三大中文字体修复策略的对比与场景建议

5. 总结

解决 Matplotlib 中文显示为方框或乱码的问题,并不需要复杂重装或修改底层库配置文件。在绝大多数日常统计与可视化场景下,只需在导入库后添加:

  • plt.rcParams['font.sans-serif'] = ['SimHei', 'Microsoft YaHei', 'PingFang SC', 'Noto Sans CJK SC']
  • plt.rcParams['axes.unicode_minus'] = False

这套配置覆盖了当前主流操作系统的中文字体回退策略,同时彻底解决了负号缺失告警,是目前最为稳健、便捷的代码级解决方案。

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。