MacOS系统下matplotlib中SimHei中文字体缺失报错的解决办法

问题描述

使用matplotlib画图时，因为缺少字体，出现warning，图像上label上的中文显示时空白小方块。因为matplotlib默认没有中文，可以调用中文字体，但是会出现如下图所示的warning：

import matplotlib.pyplot as plt
plt.rcParams['font.sans-serif'] = ['SimHei'] 
plt.rcParams['axes.unicode_minus'] = False

解决方法：

Step 1. 在终端进入python3环境，查看matplotlib字体路径：

import matplotlib    
print(matplotlib.matplotlib_fname())

找到自己的matplotlib字体文件路径：

比如/Users/dan/miniforge3/envs/py38/lib/python3.8/site-packages/matplotlib/mpl-data/matplotlibrc

Step 2. 下载SimHei.ttf字体：

国内SimHei

Step 3. 将下载好的SimHei.ttf字体移动到第一步查询到的字体目录./fonts/ttf/下：

mv ~/Downloads/SimHei.ttf ~/miniforge3/envs/py38/lib/python3.8/site-packages/matplotlib/mpl-data/fonts/ttf/SimHei.ttf

注意字体文件名称一定是：SimHei.ttf

Step 4. 打开终端，进入python环境，清理matplotlib缓冲目录：

import matplotlib
print(matplotlib.get_cachedir())

获取缓冲目录地址：/Users/dan/.matplotlib

终端输入exit()退出python环境，再删除上面找到的缓冲文件：

rm -rf /Users/dan/.matplotlib

Step 5. 修改原始文件：

打开第一步找到的字体路径：/Users/dan/miniforge3/envs/py38/lib/python3.8/site-packages/matplotlib/mpl-data/matplotlibrc进行修改：

通过vi定位几个关键点来修改：

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

通过:/内容 查找指定内容
如:/font.family， :/font.sans-serif，:/ axes.unicode_minus.

#去掉前面的#
font.family:  sans-serif
#去掉前面的#，手动加SimHei
font.sans-serif: SimHei, DejaVu Sans, Bitstream Vera Sans, Computer Modern Sans Serif, Lucida Grande, Verdana, Geneva, Lucid, Arial, Helvetica, Avant Garde, sans-serif
#去掉前面的#，把True改为False
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

Step 6. 重启，测试

import matplotlib.pyplot as plt
x = list(range(5))
y = list(range(1,10,2))
plt.plot(x,y)
plt.xlabel('x轴数据')
plt.ylabel('y轴数据')
plt.show()

不需要plt.rcParams['font.sans-serif'] = ['SimHei']就可以自动显示中文，至此中文显示的问题已经解决。

参考：link 1

问题延伸：安装Seaborn

为了进一步做数据的可视化分析，安装matplotlib后，按照以上步骤设置，可以显示中文。之后安装seaborn，但是在后续调用matplotlib或seaborn进行作图时，坐标、标题的中文又无法显示，变成白框了。

返回如下以下报错：

/Users/dan/miniforge3/lib/python3.9/site-packages/matplotlib/backends/backend_agg.py:240: RuntimeWarning: Glyph 26376 missing from current font.
  font.set_text(s, 0.0, flags=flags)
/Users/dan/miniforge3/lib/python3.9/site-packages/matplotlib/backends/backend_agg.py:240: RuntimeWarning: Glyph 19978 missing from current font.
  font.set_text(s, 0.0, flags=flags)
/Users/dan/miniforge3/lib/python3.9/site-packages/matplotlib/backends/backend_agg.py:240: RuntimeWarning: Glyph 28023 missing from current font.
  font.set_text(s, 0.0, flags=flags)
/Users/dan/miniforge3/lib/python3.9/site-packages/matplotlib/backends/backend_agg.py:240: RuntimeWarning: Glyph 26085 missing from current font.
  font.set_text(s, 0.0, flags=flags)
/Users/dan/miniforge3/lib/python3.9/site-packages/matplotlib/backends/backend_agg.py:240: RuntimeWarning: Glyph 26032 missing from current font.
  font.set_text(s, 0.0, flags=flags)
/Users/dan/miniforge3/lib/python3.9/site-packages/matplotlib/backends/backend_agg.py:240: RuntimeWarning: Glyph 22686 missing from current font.
  font.set_text(s, 0.0, flags=flags)

但是卸载seaborn后又可以正常显示中文。到底是怎么回事？

问题探究：
设置中文显示，涉及到matplotlib的图像默认属性修改。

seaborn是基于matplotlib库，是整合matplotlib各种绘图函数和设置函数的高级接口，可以理解为seaborn是个中间翻译，用户将绘图命令发给seaborn，seaborn再翻译给matplotlib，matplotlib再按命令绘图。用户也可以直接将绘图语言发给matplotlib。只不过与seaborn沟通的语言更简单易用，与matplotlib沟通就有些繁琐。

所以，在seaborn中修改样式，最终还是在修改matplotlib的样式参数。

解决方法：

虽然已经处理了matplotlib中SimHei中文字体缺失，但是为了在seaborn中显示中文，还需要利用set()的rc参数传递设置，修改rcParams中的字体为中文字体。主要修改两个参数：

• font.sans-serif: 设置图像中的非衬线字体，必须是操作系统或matplotlib内置的字体，下文用黑体（SimHei）做示例；
• axes.unicode_minus: 设置为False，解决中文字体下显示不出负号。

如下所示：

import pandas as pd
import matplotlib.pyplot as plt
import seaborn as sns
%matplotlib inline

tips = pd.read_csv('./seaborn-data-master/tips-zh.csv')
rc = {'font.sans-serif': 'SimHei',
      'axes.unicode_minus': False}
sns.set(context='notebook', style='ticks', rc=rc)
sns.catplot(x="日期", y="总账单", data=tips)
plt.show()

欢迎各位关注我的个人公众号：HsuDan，我将分享更多自己的学习心得、避坑总结、面试经验、AI最新技术资讯。