matplotlib默认不支持中文是因为字体路径未指向含中文的字体文件,需通过rcParams设置font.sans-serif为可用中文字体名(如'SimHei')并关闭axes.unicode_minus。

matplotlib 默认不支持中文,直接绘图时汉字会变成方框——根本原因是字体路径未正确指向含中文的字体文件,而 matplotlib.rcParams 是最直接的干预入口。
确认系统中可用的中文字体
不是所有中文字体都能被 matplotlib 识别,必须用 matplotlib.font_manager.findSystemFonts() 扫描后筛选出真正能加载的字体名(注意:是字体的 显示名称,不是文件名)。
- 在 Python 中运行:
import matplotlib.font_manager as fm<br>fonts = [f.name for f in fm.fontManager.ttflist]<br>print([f for f in fonts if 'Sim' in f or 'Noto' in f or 'Source' in f or 'FangSong' in f])
- 常见有效字体名包括:
SimHei(Windows)、Noto Sans CJK SC(macOS/Linux)、Source Han Serif CN、FangSong - 别直接写
"simhei.ttf"这类路径——rcParams不接受文件路径,只接受字体名(family name)
用 rcParams 设置中文字体和无衬线默认族
只设 font.sans-serif 不够,必须同时关闭 axes.unicode_minus,否则负号会变成方块。
- 推荐写法(兼容多数环境):
import matplotlib.pyplot as plt<br>plt.rcParams['font.sans-serif'] = ['SimHei', 'Noto Sans CJK SC', 'FangSong']<br>plt.rcParams['axes.unicode_minus'] = False
-
font.sans-serif是列表,matplotlib 按顺序尝试,第一个可用即生效;把最可能存在的字体放前面 - 不要设
font.family为'sans-serif'以外的值(如'serif'),否则可能触发 fallback 到无中文的英文字体 - 该配置需在
import matplotlib.pyplot后、任何绘图命令前执行;模块级配置优先于plt.style.use()
验证是否生效及快速回退方案
设置后不立即生效?常见原因不是代码错,而是字体缓存没更新或 pyplot 实例已初始化。
- 强制刷新字体缓存:
import matplotlib.font_manager as fm<br>fm._rebuild()
(执行后需重启 kernel 或新建 session) - 临时绕过 rcParams,单图指定字体:
plt.title('标题', fontfamily='SimHei'),可用于快速验证字体名是否正确 - 如果图表已渲染出方框,仅改 rcParams 不会重绘——必须重新调用
plt.plot()等绘图函数 - Linux 下若无中文字体,可手动安装:
sudo apt install fonts-noto-cjk(Ubuntu/Debian)
最易被忽略的是 axes.unicode_minus ——它和中文显示无关,但一旦为 True,所有负号(如坐标轴刻度 -1、-2)都会变方框,看起来像“中文又坏了”,实际是独立开关。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











