我们来解决一下 matplotlib 的中文显示问题

用 matplotlib 绘制图表,默认设置下,是无法在图中正确显示中文的。原因无非两种,一种是字符编码不正确,一种是字体不支持中文。前一种情况总是发生在 Python 2 用户身上,解决方法是把字符转成 UTF-8。而 Python 3 统一使用 Unicode,不存在这个问题。

本文主要解决的是第二种问题:字体不支持中文。

背景知识

想快速解决问题可直接跳到步骤一,有不明白的地方再来阅读背景知识。

matplotlib 从配置文件 matplotlibrc 中读取配置,字体相关内容也在其中。matplotlib 依次在以下四个位置寻找配置文件:

  1. 当前工作目录下的 matplotlibrc
  2. $MATPLOTLIBRC/matplotlibrc
  3. 用户家目录下的 matplotlibrc。 如 Linux 一般在 ~/.config/matplotlib/matplotlibrc, macOS 在 ~/.matplotlib/matplotlibrc
  4. INSTALL/matplotlib/mpl-data/matplotlibrc,其中 INSTALL 指具体的安装目录。

详见官方文档。查询当前使用的 matplotlibrc 所在目录,可以用 get_configdir() 函数:

import matplotlib
matplotlib.get_configdir()

这里有一份配置文件示例可供下载。

阅读配置文件可以发现,matplotlib 默认使用的 font.familysans-serif,即无衬线字体,而无衬线字体又是从这几种字体中依次选用:

font.sans-serif : Bitstream Vera Sans, Lucida Grande, Verdana, Geneva, Lucid, Arial, Helvetica, Avant Garde, sans-serif

全是西文字体,没一个支持中文的。而且 matplotlib 对字体文件的格式也很挑剔,除了 .ttf 其他一概不认。比如 macOS Sierra 中的 Lucida Grande 是 .ttc 格式,即便按照顺位轮到它了,仍然会被跳过。

查询当前的 font.family

matplotlib.font_manager.FontProperties().get_family()

查询当前使用字体:

from matplotlib.font_manager import findfont, FontProperties
findfont(FontProperties(family=FontProperties().get_family()))

铺垫结束,我们利用上面的知识解决问题。


步骤一

Python 2 用户请先确认字符编码为 UTF-8。Python 3 用户直接跳过此步骤。

步骤二

寻找支持中文并且安装为 .ttf 格式的字体。

Windows 用户应该总能找到 SimHei.ttf。*nix 用户可以通过 fc-list 命令或者图形工具在当前系统内查询。如果不幸真没找到符合条件的,你就得自己去下载一个或者进行格式转换了。SimHei.ttf 应该很容易找到,然而其实是未获授权的。文泉驿微米黑是一种自由字体,推荐使用。

.ttc 转换为 .ttf,网上有不少在线或线下工具,可以自行搜索。

友情提示一句,请选择各种黑体作为图表中的字体,宋体放在图表中,丑死了。

步骤三

新安装的字体 matplotlib 一时不能找到,需要更新字体列表缓存。

如果你建立了 ~/.matplotlib/ 目录的话,应该会在其中找到 fontList.py3k.cache。在其中找到 Vera.ttf 的安装目录,把新安装的字体复制到该目录下。

删除 fontList.py3k.cache。matplotlib 下次启动时会重建缓存,新字体随之被添加。

步骤四

现在就要在程序中使用中文字体了。

首先,你得知道字体的英文名称,比如 SimHei.ttf 就叫 SimHei,文泉驿微米黑叫 WenQuanYi Micro Hei。

然后,你有两种方法告诉 matplotlib 使用这些字体:

  1. matplotlibrc 中,添加像这样的一行:
font.sans-serif : WenQuanYi Micro Hei, Bitstream Vera Sans, Lucida Grande, Verdana, Geneva, Lucid, Arial, Helvetica, Avant Garde, sans-serif

把中文字体作为第一顺序选用的字体。

  1. 在程序文件开头,指定字体:
import matplotlib
matplotlib.rcParams['font.sans-serif'] = 'WenQuanYi Micro Hei'

第2种方法很灵活,可以针对每个文件单独设置。如果使用第1种方法,建议把 matplotlibrc 放在当前工作目录下,不要作为全局配置。


好了,配置完成,效果如图:

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容