Python Matplotlib 中直接加载本地字体文件
flyfish
python实现 绕过操作系统的字体库,直接读取本地字体文件,将其注册到 Matplotlib 的字体管理体系中
查找所有中文字体(含文件路径)
fc-list:lang=zh-f"%{file}\n"这里以NotoSansCJK-Regular.ttc字体文件举例
NotoSansCJK-Regular.ttc介绍
Noto:字体项目名称
No Tofu(无豆腐块)早期不同语言在系统中无对应字体时,文字会显示为「□」(豆腐块 / Tofu),彻底解决「豆腐块」问题。Sans:字体风格(无衬线)
Sans = Sans-serif(无衬线),是字体的外观风格:
「衬线(Serif)」:字体笔画末端有装饰性小短线
「无衬线(Sans)」:笔画末端无装饰
Noto Sans 适合屏幕显示,Noto Serif(衬线版)适合印刷 / 文档。CJK:语言覆盖范围
全称:Chinese + Japanese + Korean(中、日、韩)。
中日韩三国文字共享大量汉字(形异 / 音异 / 义异),Noto 将这三种语言的字符整合到同一字体家族中,避免单独设计多套字体,同时保证字符风格统一。Noto CJK 还包含越南喃字等衍生字符,是覆盖最完整的 CJK 开源字体。ttc 格式文件是 TrueType Collection(TrueType 字体集合),是把多个 TTF 字体打包到一个文件里,比如 NotoSansCJK-Regular.ttc 包含了简 / 繁 / 日 / 韩等 CJK 字体变体
| 特征 | TTF(TrueType Font) | TTC(TrueType Collection) |
|---|---|---|
| 本质 | 单个字体文件 | 多个 TTF 字体的「打包集合文件」 |
| 文件内容 | 仅包含一套字体(如简体中文) | 包含多套字体(如简/繁/日/韩 CJK 变体) |
| 体积 | 较小(单变体) | 较大(多变体打包) |
一、复制 .ttc 字体文件到项目目录
执行以下命令,把系统中的NotoSansCJK-Regular.ttc复制到项目的fonts文件夹
# 1. 新建fonts文件夹(替换为你的项目路径,比如~/my_plot_project)mkdir-p ~/my_plot_project/fonts# 2. 复制.ttc文件到fonts目录cp/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc ~/my_plot_project/fonts/二、Python 加载 .ttc 字体并绘制中文
.ttc是字体集合,加载时 Matplotlib 会自动识别其中的简体中文字体,代码和加载.ttf几乎一致:
importosimportmatplotlib.pyplotaspltfrommatplotlibimportfont_manager# --------------------------# 1. 配置.ttc字体文件路径(跨系统兼容)# --------------------------# 注意:文件名是NotoSansCJK-Regular.ttc(和你找到的一致)FONT_FILE="NotoSansCJK-Regular.ttc"font_path=os.path.join(os.path.dirname(os.path.abspath(__file__)),# 当前脚本所在目录"fonts",FONT_FILE)# 验证文件是否存在(避免路径错误)ifnotos.path.exists(font_path):raiseFileNotFoundError(f"字体文件不存在:{font_path}\n请检查复制的路径是否正确")# --------------------------# 2. 注册.ttc字体并全局配置# --------------------------# 注册字体集合文件到Matplotlibfont_manager.fontManager.addfont(font_path)# 获取字体名称(Matplotlib会自动识别.ttc中的简体中文字体)font_name=font_manager.FontProperties(fname=font_path).get_name()print(font_name)# 中文显示核心配置(必加)plt.rcParams['font.family']=font_name# 全局默认用该中文字体plt.rcParams['axes.unicode_minus']=False# 解决负号显示方块问题# --------------------------# 3. 绘图验证中文显示# --------------------------fig,ax=plt.subplots(figsize=(8,5),dpi=100)# 绘制示例数据(含负号,测试兼容性)x=[1,2,3,4,5]y=[120,-50,200,80,-30]ax.plot(x,y,linewidth=2,color="#2E86AB",marker="o",label="简体中文标签")# 所有文本直接写中文,无需额外指定字体ax.set_title("标题:NotoSansCJK-Regular.ttc 测试",fontsize=16)ax.set_xlabel("横轴:月份(1-5月)",fontsize=12)ax.set_ylabel("纵轴:销售额(万元)",fontsize=12)ax.legend(loc="upper right")# 图例(中文)ax.text(3,150,"注释:负数值测试 -50.8",fontsize=10)# 含负号的中文# 调整布局,避免文字裁剪plt.tight_layout()# 保存图片(跨系统打开均能显示中文)plt.savefig("chinese_plot_ttc.png",dpi=100)plt.show()# 验证加载的字体名称(可选)print(f"成功加载的字体名称:{font_name}")# 输出示例:Noto Sans CJK SC(自动识别简体中文变体)只需将fonts/NotoSansCJK-Regular.ttc和 Python 脚本一起打包,目录结构如下:
my_plot_project/ ├── plot_chinese.py # 绘图脚本 └── fonts/ └── NotoSansCJK-Regular.ttc # 复制的.ttc字体文件