Python Matplotlib 中直接加载本地字体文件
2026/4/15 5:59:16 网站建设 项目流程

Python Matplotlib 中直接加载本地字体文件

flyfish

python实现 绕过操作系统的字体库,直接读取本地字体文件,将其注册到 Matplotlib 的字体管理体系中

查找所有中文字体(含文件路径)

fc-list:lang=zh-f"%{file}\n"

这里以NotoSansCJK-Regular.ttc字体文件举例
NotoSansCJK-Regular.ttc介绍

  1. Noto:字体项目名称
    No Tofu(无豆腐块)早期不同语言在系统中无对应字体时,文字会显示为「□」(豆腐块 / Tofu),彻底解决「豆腐块」问题。

  2. Sans:字体风格(无衬线)
    Sans = Sans-serif(无衬线),是字体的外观风格:
    「衬线(Serif)」:字体笔画末端有装饰性小短线
    「无衬线(Sans)」:笔画末端无装饰
    Noto Sans 适合屏幕显示,Noto Serif(衬线版)适合印刷 / 文档。

  3. CJK:语言覆盖范围
    全称:Chinese + Japanese + Korean(中、日、韩)。
    中日韩三国文字共享大量汉字(形异 / 音异 / 义异),Noto 将这三种语言的字符整合到同一字体家族中,避免单独设计多套字体,同时保证字符风格统一。Noto CJK 还包含越南喃字等衍生字符,是覆盖最完整的 CJK 开源字体。

  4. 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字体文件

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询