Matplotlib标注中LaTeX两位数下标无法正常显示问题

核心原因 #

Matplotlib默认的内置数学文本解析器（mathtext）对部分复杂LaTeX语法支持有限，尤其是多位数下标；另外Python字符串中的大括号需要正确转义，否则LaTeX无法识别完整的下标内容。

解决方案 #

1. 启用LaTeX原生渲染

首先确保Matplotlib使用系统LaTeX渲染文本，这是解决复杂LaTeX语法问题的根本：

import matplotlib.pyplot as plt

# 配置LaTeX渲染
plt.rcParams.update({
    "text.usetex": True,
    "font.family": "serif",
    "font.serif": ["Computer Modern Roman"],  # 可选，指定LaTeX字体
})

注：系统需要预先安装LaTeX环境（如TeX Live、MiKTeX），否则会报错。

2. 正确转义字符串中的大括号

不管用f-string还是format格式化，都要对LaTeX下标中的大括号进行转义：

• f-string写法（推荐用原始f-string）：

step = 10
# 用双大括号包裹下标变量，fr字符串避免转义冲突
label = fr"$f_{{{step}}}$"

# 示例：添加到图表
plt.plot([1, 2, 3], [step, step+1, step+2], label=label)
plt.legend()
plt.show()

• format格式化写法：

step = 10
# 用双大括号转义，确保LaTeX拿到{10}
label = r"$f_{{{}}}$".format(step)

# 示例使用
plt.xlabel(f"迭代步长: {step}, 函数值{label}")
plt.show()

3. 内置mathtext的兼容方案（无LaTeX环境时）

如果无法安装LaTeX环境，可以尝试升级Matplotlib版本，或显式指定mathtext的解析规则：

plt.rcParams["mathtext.fontset"] = "cm"  # 使用Computer Modern字体的mathtext
step = 10
label = rf"$f_{{{step}}}$"
plt.title(label)
plt.show()

这种方法对大部分多位数下标场景有效，但复杂LaTeX语法仍推荐用原生LaTeX渲染。

验证方法 #

运行上述代码后，查看图表中的标注，两位数下标（如$f_{10}$）应完整显示为带有下标10的函数符号，而非只显示$f_1$或其他异常格式。

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