Matplotlib Runtime Error求助：LaTeX未找到报错排查

报错原因 #

你设置了plt.rcParams['text.usetex'] = True，这会让Matplotlib调用LaTeX渲染文本，但你的系统未安装LaTeX环境，或者Matplotlib无法定位LaTeX的可执行文件路径，因此触发该错误。重置rcParams无效，大概率是因为你没关闭text.usetex参数，或重置后又重新开启了它。

两种解决方案 #

方案1：关闭LaTeX渲染（快速解决） #

直接删除plt.rcParams['text.usetex'] = True这行，或改成False。Matplotlib会用内置的Mathtext渲染公式，无需依赖外部LaTeX：

# 替换原代码中的对应行
plt.rcParams['text.usetex'] = False

方案2：安装LaTeX环境（适配高质量渲染需求） #

• Windows：安装MiKTeX或TeX Live，选择「完整安装」，确保latex.exe被添加到系统环境变量PATH中。
• macOS：安装MacTeX，确认LaTeX可执行文件路径在系统PATH内。
• Linux：通过包管理器安装，比如Ubuntu/Debian执行sudo apt-get install texlive-full，CentOS/RHEL执行sudo yum install texlive-scheme-full。

安装完成后重启Python环境，再运行代码即可。

额外排查点 #

若已安装LaTeX仍报错，可手动指定LaTeX路径：

plt.rcParams['text.latex.preamble'] = r'\usepackage{amsmath}'
plt.rcParams['text.latex.unicode'] = True
# 根据实际安装路径修改，以下为Linux示例
plt.rcParams['pgf.latex.system'] = 'pdflatex'
plt.rcParams['pgf.latex.executable'] = '/usr/bin/pdflatex'

内容的提问来源于stack exchange，提问作者The Robotics Guy