Matplotlib样式表字体字符串解析错误：自定义字体路径配置问题

问题场景 #

在Matplotlib中尝试通过样式表指定自定义.ttf文件作为斜体数学字体，配置行如下：

mathtext.it: "/path/to/fontname-Italic-VariableFont_wght.ttf"

运行脚本时触发如下警告：

文件'~/path/to/stylesheet.mplstyle'第30行存在无效值
('mathtext.it: "/path/to/fontname-Italic-VariableFont_wght.ttf"'):
键mathtext.it：无法解析字体字符串：
'"/path/to/fontname-Italic-VariableFont_wght.ttf"' 预期文本结束，却找到'-'（位于字符36），(行:1, 列:37)

错误原因 #

Matplotlib的mathtext系列配置项不支持直接传入字体文件路径，这类配置需要使用字体的名称而非文件路径来指定。

解决方法 #

1. 加载自定义字体
   先通过Python代码将字体文件加载到Matplotlib的字体管理器中，同时获取字体名称：

   from matplotlib import font_manager
   
   # 替换为你的字体文件路径
   font_file_path = "/path/to/fontname-Italic-VariableFont_wght.ttf"
   font_manager.fontManager.addfont(font_file_path)
   # 获取字体的正式名称
   target_font_name = font_manager.FontProperties(fname=font_file_path).get_name()
   

   运行这段代码后，target_font_name会得到该字体的实际名称（比如"Roboto Italic"）。

2. 修改样式表配置
   在样式表中使用获取到的字体名称替换原文件路径：

   mathtext.it: "target_font_name"
   

   注意将target_font_name替换为实际获取到的字体名称。

内容的提问来源于stack exchange，提问作者darthV