Termux中Matplotlib无法显示中文的解决方案

凌晨两点半

发布时间：2026-10-14 | 4人浏览过

原创

本文介绍在Termux环境中使用Matplotlib绘图时中文标题显示为方框的问题。通过替换系统字体文件、修改matplotlibrc配置文件以及调整保存图像的代码逻辑，实现横纵坐标中文正常显示。

问题背景

在正式介绍解决方案之前，首先要感谢用户名为怜索的朋友，他给予了本博客2021年的第一个点赞支持。


import numpy as np
import matplotlib
import matplotlib.pyplot as plt
import os
matplotlib.rcParams['xtick.direction'] = 'in'
matplotlib.rcParams['ytick.direction'] = 'in'
plt.rcParams['axes.unicode_minus'] = False # 用来正常显示负号
#显示中文
plt.rcParams['font.sans-serif'] = ['simhei']
x = np.linspace(-1,1,50)#从(-1,1)均匀取50个点
y = 2 * x
plt.plot(x,y)

plt.xlabel("吸光值")
plt.ylabel("浓度")
plt.show()

前文提供的代码在Windows和Linux系统下，横纵坐标的标题均能正确显示中文。然而，在Termux环境中运行上述代码，效果却如上图所示，中文显示异常。

解决方案

首先，需要从Windows电脑或当前使用的系统中获取中文字体文件，也可以前往https://github.com/dolbydu/font网站下载所需字体（该网站目前可能需要使用代理访问）。本文以黑体文件simhai.ttf为例进行说明。

接下来，将下载好的simhai.ttf文件移动到Termux中Matplotlib的字体目录下，具体路径为/data/data/com.termux/files/usr/lib/python3.9/site-packages/matplotlib/mpl-data/fonts/ttf。

随后，需要修改matplotlibrc配置文件，以确保Matplotlib能够正确调用新添加的字体。


#去掉注释
font.family      : sans-serif
#去掉注释，并在冒号后的值前添加前文提及的中文字体
font.sans-serif  : STKaiti, Simhei........
#删除matplotlib缓存
rm -rf ~/.cache/matplotlib

测试

使用与前文相同的代码进行测试。


import numpy as np
import matplotlib
import matplotlib.pyplot as plt
import os
#设置坐标轴朝向
matplotlib.rcParams['xtick.direction'] = 'in'
matplotlib.rcParams['ytick.direction'] = 'in'
plt.rcParams['axes.unicode_minus'] = False # 用来正常显示负号
#显示中文
plt.rcParams['font.sans-serif'] = ['simhei']
x = np.linspace(-1,1,50)#从(-1,1)均匀取50个点
y = 2 * x
plt.plot(x,y)

plt.xlabel("吸光值")
plt.ylabel("浓度")
#由于termux没有图像界面，因此不能够使用plt.show()，因此用plt.savefig()配合termux-open命令替代
plt.savefig("test2.png")
os.system("termux-open test2.png")

运行后的效果如下图所示，中文显示已恢复正常。

附加：Matplotlib中文字体目录

以下是Matplotlib支持的部分中文字体名称对照：黑体：SimHei 微软雅黑：Microsoft YaHei 微软正黑体：Microsoft JhengHei 新宋体：NSimSun 新细明体：PMingLiU 细明体：MingLiU 华文新魏:STXinwei 华文行楷：STXingkai 华文隶书：STLliti 花纹琥珀：STHupo 华文彩云：STCaiyun 方正姚体：FZYaoti 方正舒体：FZShuTi 标楷体：DFKai-SB 华文仿宋：STFangsong 华文中宋：STZhongsong 华文宋体：STSong 华文楷体：STKaiti 华文细黑：STXihei 幼圆：YouYuan 隶书：LiSu 楷体_GB 2313:Kaiti_GB2313 仿宋_GB2313:FangSong_GB2313 仿宋：FangSong

至此，关于在Termux中解决Matplotlib无法显示中文问题的方法介绍完毕。如需了解更多Termux与Matplotlib相关的内容，欢迎搜索本站往期文章或继续浏览后续文章，感谢大家的支持。