Matplotlib自定义LaTeX导言区报错：无法将列表转换为字符串

问题原因 #

Matplotlib 3.3及以上版本对text.latex.preamble的参数类型做了变更：不再接受列表，必须传入单个字符串。你遇到的ValueError: Key text.latex.preamble: Could not convert [...] to str就是因为传入了列表而非字符串导致的。至于反斜杠显示成双反斜杠，这只是Python对转义字符的打印表示，实际传递给LaTeX的是正确的单反斜杠，无需额外处理。

解决方法 #

方法1：直接使用多行字符串

把导言区内容合并成一个多行原始字符串（用r'''...'''包裹），保持代码可读性：

import matplotlib.pyplot as plt
from matplotlib import rcParams

rcParams['text.usetex'] = True
rcParams['text.latex.preamble'] = r'''
\usepackage{siunitx}
\sisetup{detect-all}
\usepackage{helvet}
\usepackage{sansmath}
\sansmath
'''

fig, ax = plt.subplots()
fig.show()

方法2：列表转字符串

如果想保留列表的分段写法，用'\n'.join()将列表元素合并为单个字符串：

import matplotlib.pyplot as plt
from matplotlib import rcParams

rcParams['text.usetex'] = True
preamble_lines = [
       r'\usepackage{siunitx}',
       r'\sisetup{detect-all}',
       r'\usepackage{helvet}',
       r'\usepackage{sansmath}',
       r'\sansmath'
]
rcParams['text.latex.preamble'] = '\n'.join(preamble_lines)

fig, ax = plt.subplots()
fig.show()

额外注意 #

确保你的系统已安装所需的LaTeX包（siunitx、helvet、sansmath），否则会触发LaTeX编译错误，这不属于Matplotlib配置问题。

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