linux系统matplotlib无法正常显示中文字体的解决办法（Generic family ‘sans-serif‘ not found）

问题描述

首先使用下面指令安装文泉驿字体

sudo apt-get install ttf-wqy-zenhei

代码中配置matplotlib字体

plt.rcParams['font.sans-serif'] = ['WenQuanYi Zen Hei']
plt.rcParams['axes.unicode_minus'] = False

报错（无法识别对应的中文字体WenQuanYi Zen Hei）

2024-08-12 12:41:09 - WARNING - font_manager.py:1365 - findfont: Generic family 'sans-serif' not found because none of the following families were found: WenQuanYi Zen Hei

报错分析

可能原因：linux系统安装中文字体后，matplotlib未将安装后的字体添加到缓存目录，导致中文字体无法正常解析。

解决办法

• 进入python编译器，依次执行以下代码，查看字体缓存目录

import matplotlib as mpl
mpl.get_cachedir()

• 删除matplotlib字体缓存文件：

rm -rf /root/.cache/matplotlib/*

验证结果

• 重新执行python画图脚本（此处是相对路径执行方法，根据自己脚本执行命令执行即可）

python -m test.predict

• 显示重新生成字体配置文件则表示重新加载了字体缓存
  
• 最终画图结果（中文正常显示）