Mac系统下Matplotlib调用LaTeX报错的解决方案咨询

以下是针对性的排查和解决步骤：

1. 确认系统LaTeX路径并配置Matplotlib #

MacTeX的latex可执行文件默认路径为/Library/TeX/texbin/latex，先在终端验证是否可访问：

which latex

如果输出上述路径，在Python代码中手动指定Matplotlib的LaTeX配置：

import matplotlib.pyplot as plt
plt.rcParams.update({
    "text.usetex": True,
    "text.latex.preamble": r"\usepackage{amsmath}",
    # 若latex路径不在默认PATH，需添加以下行
    "text.latex.command": "/Library/TeX/texbin/latex"
})

2. 修复系统PATH环境变量 #

如果终端执行latex --version报错，说明MacTeX的路径未加入系统PATH：

• 临时生效：终端执行

  export PATH="/Library/TeX/texbin:$PATH"
  

• 永久生效：编辑~/.zshrc（Zsh）或~/.bash_profile（Bash），添加上述export语句，然后执行source ~/.zshrc（对应shell）重启环境。

同时确保Mac Ports的路径（默认/opt/local/bin）也在PATH中，保证dvipng和ghostscript可被访问：

export PATH="/opt/local/bin:$PATH"

3. 清理无用依赖并验证工具可用性 #

Python的latex包对Matplotlib无作用，可卸载：

pip uninstall latex

验证dvipng和ghostscript（命令为gs）是否正常：

which dvipng
which gs

若无输出，需重新通过Mac Ports安装对应工具。

4. 用最小示例测试 #

排除业务代码干扰，运行以下最小测试代码：

import matplotlib.pyplot as plt
plt.rcParams["text.usetex"] = True
plt.plot([1,2,3], [4,5,6])
plt.xlabel(r"\textbf{X轴}")
plt.ylabel(r"\textit{Y轴}")
plt.title(r"\LaTeX 测试")
plt.savefig("test.pdf")
plt.show()

若报错提示缺少LaTeX包，可通过TeX Live Utility搜索并安装缺失包（如amsmath）。

5. 切换至PGF后端 #

若上述方法无效，尝试使用Matplotlib的PGF后端（对LaTeX支持更稳定）：

import matplotlib.pyplot as plt
plt.switch_backend('pgf')
plt.rcParams.update({
    "pgf.texsystem": "pdflatex",
    "font.family": "serif",
    "text.usetex": True,
    "pgf.rcfonts": False,
})
# 后续绘图代码

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