Matplotlib中使用\textbf触发ValueError错误的原因及粗体文本实现方法咨询

API 探路者

2026-4-8

嘿，我完全懂你遇到的这个头疼问题！咱们先来拆解一下错误原因：

你用 $...$ 把内容包裹成了数学公式环境，但Matplotlib默认的mathtext解析器，在数学模式下是不支持直接用文本模式的\textbf命令的。解析器看到\textbf的时候，它以为你要切换到文本模式，所以期望看到的是\text命令，结果却看到了bf，这就直接触发了那个ParseSyntaxException错误。

接下来给你几个靠谱的解决办法，按需选就行：

用数学模式专属的粗体命令\mathbf
这是处理纯公式粗体最直接的方式，\mathbf是LaTeX数学环境里原生的粗体命令，Matplotlib的解析器能直接识别。修改你的标注代码：
```
import matplotlib.pyplot as plt
fig, ax = plt.subplots(figsize=(6, 4))
# 用\mathbf实现公式粗体
ax.annotate(r"$\mathbf{y = -\,\frac{1}{\sqrt{2}}x + 1}$", xy=(0.2, 0.7), rotation=-35, fontsize=12)
plt.show()
```
这里注意把之前的fontweight='bold'去掉就行，因为\mathbf已经帮你实现粗体效果了，这个参数在公式环境里也不会生效。
切换到文本模式用\textbf
如果你非得用\textbf，那得先在数学环境里用\text命令切换到文本模式，再用\textbf包裹内容。或者也可以把公式嵌在文本环境里，示例如下：
方式一（数学环境内转文本）：
```
ax.annotate(r"$\text{\textbf{y = -\,\frac{1}{\sqrt{2}}x + 1}}$", xy=(0.2, 0.7), rotation=-35, fontsize=12)
```
方式二（文本环境包裹公式）：
```
ax.annotate(r"\textbf{y = $-\,\frac{1}{\sqrt{2}}x + 1$}", xy=(0.2, 0.7), rotation=-35, fontsize=12)
```
这种写法适合你需要混合纯文本和公式的场景，外层的\textbf能给整个内容（包括嵌在里面的公式）加粗。