Python - matplotlib 不显示中文 && findfont: Font family [‘SimHei‘] not found - IOS

BIT_666

已于 2022-06-10 11:39:37 修改

阅读量1.5w

点赞数 46

分类专栏： Python 异常解决文章标签： python matplotlib 显示中文 SimHei

于 2022-01-07 16:34:27 首次发布

本文链接：https://blog.csdn.net/BIT_666/article/details/122365074

版权

Python 同时被 2 个专栏收录

90 篇文章

订阅专栏

异常解决

56 篇文章

订阅专栏

本文详细介绍了如何修复Python Matplotlib在设置图表标题时无法正常显示中文的错误。首先尝试通过全局配置`plt.rcParams['font.sans-serif']=['SimHei']`来解决，如果出现字体找不到的报错，则需要下载SimHei.ttf字体文件并将其拷贝到matplotlib的font文件夹。接着修改matplotlib配置文件，取消相应注释并添加SimHei到字体列表，同时将`axes.unicode_minus`设为False。清除matplotlib缓存后，问题通常可以得到解决。若问题依然存在，重启编辑器可能有所帮助。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一.引言

python matplotlib.plt 使用 plt.title 写标题时，标题显示为方框，无法正常显示中文，遂开始修复之旅。

二.解决方案

查询网上大神给出的解决方案是添加全局字体配置:

plt.rcParams['font.sans-serif'] = ['SimHei']

如果添加后运行代码无 findfont: Font family ['SimHei'] not found 报错且正常显示中文，那很奈斯，后面的就不用操作了，如果添加后显示如下报错则革命尚未成功，同志仍需努力：

findfont: Font family ['SimHei'] not found. Falling back to DejaVu Sans.
/Users/xxx/miniforge3/envs/macm1tf/lib/python3.8/site-packages/matplotlib/backends/backend_agg.py:240: RuntimeWarning: Glyph 23089 missing from current font.
  font.set_text(s, 0.0, flags=flags)

上述报错代表 matplotlib 库内没有 SimHei 字体，所以需要下载相关文件，SimHei 就是最常见的黑体。

三.安装 SimHei.ttf 并配置 matplotlib

1.下载 SimHei.ttf

下载地址: SimHei.ttf 下载地址，进入界面下载对应文件即可，如果下载失败也可以留下邮箱 📮

2.拷贝 SimHei.ttf 到 matplotlib 的 font 文件夹

下载成功后在自己对应的 python 程序内执行下述语句找到 matplotlib 存放 font 的位置:

import matplotlib
print(matplotlib.matplotlib_fname())

会得到类似下述地址，以 matplotlibrc 结尾：

/Users/xxxx/miniforge3/envs/macm1tf/lib/python3.8/site-packages/matplotlib/mpl-data/matplotlibrc

以这个路径为基础截取至 mpl-data，然后执行下述命令拷贝 SimHei.ttf 到 font 文件夹:

cd /Users/xxx/miniforge3/envs/macm1tf/lib/python3.8/site-packages/matplotlib/mpl-data/fonts/ttf
cp /downLoadPath/SimHei.ttf .

3.修改 Matplotlib 配置

import matplotlib
print(matplotlib.matplotlib_fname())

继续通过该命令获得 matplotlib 的配置文件：

vi /Users/xxxx/miniforge3/envs/macm1tf/lib/python3.8/site-packages/matplotlib/mpl-data/matplotlibrc

执行下述命令找到如图所示相关位置:

:/sans-serif

修改1 ：去掉 font.family 前的 # 号 (256行附近)

#font.family:  sans-serif
↓
font.family:  sans-serif

修改2：去掉 font.sans-serif 的 # 号，并加入 SimHei (260行附近)

#font.serif:      DejaVu Serif, Bitstream Vera Serif, Computer Modern Roman, New Century Schoolbook, Century Schoolbook L, Utopia, ITC Bookman, Bookman, Nimbus Roman No9 L, Times New Roman, Times, Palatino, Charter, serif
↓
font.serif:      SimHei, DejaVu Serif, Bitstream Vera Serif, Computer Modern Roman, New Century Schoolbook, Century Schoolbook L, Utopia, ITC Bookman, Bookman, Nimbus Roman No9 L, Times New Roman, Times, Palatino, Charter, serif

修改3：axes.unicode_minus 修改为 False (405行附近)

#axes.unicode_minus: True # use Unicode for the minus symbol rather than hyphen.  See
                           # https://en.wikipedia.org/wiki/Plus_and_minus_signs#Character_codes
↓
axes.unicode_minus: False # use Unicode for the minus symbol rather than hyphen.  See
                           # https://en.wikipedia.org/wiki/Plus_and_minus_signs#Character_codes

修改后 wq 即可，配置文件修改完毕。

4.清空原有配置

通过下述命令获取 matplotlib 缓存位置，还是在自己对应 python 项目中执行:

import matplotlib
print(matplotlib.get_cachedir())

通过该命令获取 cache 地址，一般在 /Users 下自己对应的账号下：

/Users/xxx/.matplotlib

执行 rm =r 斩断一切祸源：

rm -r /Users/xxx/.matplotlib

5.再次执行任务

大功告成，如果执行无效的话可以重启 pycharm 或者编辑器重试。同时也不需要再配置该参数:

# plt.rcParams['font.sans-serif'] = ['SimHei']