Matplotlib启用usetex模式调用TexLive报LaTeX进程创建失败求助

核心原因 #

该报错并非LaTeX本身编译流程出错，而是Matplotlib在Windows环境下无法正确定位、启动latex可执行文件触发的进程创建失败。结合已安装TexLive、cmd下可正常调用latex、此前曾安装MikTeX的场景，根因集中在Matplotlib路径缓存、进程环境变量继承、旧软件路径残留三类。

分步解决方法 #

• 清理Matplotlib旧缓存配置
  进入Matplotlib用户配置目录（Windows下默认路径为C:\Users\<当前系统用户名>\.matplotlib），删除目录下的tex.cache缓存文件夹，以及手动修改过的matplotlibrc配置文件。此前安装MikTeX期间，Matplotlib会将自动探测到的latex路径写入缓存，切换到TexLive后旧缓存会指向已经卸载的不存在的路径，直接触发进程创建失败。
• 手动指定LaTeX相关可执行文件绝对路径
  跳过Matplotlib的自动路径探测逻辑，在启用usetex配置前，通过rc参数直接指定TexLive对应的可执行文件路径（根据实际TexLive安装版本调整路径中的版本号部分，默认安装路径下可执行文件位于C:\texlive\<版本号>\bin\windows目录下），参考配置代码：

  import matplotlib.pyplot as plt
  # 启用TeX渲染前先指定可执行路径
  plt.rcParams['latex.executable'] = r"C:\texlive\2024\bin\windows\latex.exe"
  plt.rcParams['dvipng.executable'] = r"C:\texlive\2024\bin\windows\dvipng.exe"
  # 启用TeX渲染
  plt.rc('text', usetex=True)
  

• 解决IDE进程的环境变量继承问题
  安装TexLive后，若未完全关闭重启IDE，IDE进程会继承安装前的旧系统环境变量，即便外部命令行可正常调用latex，IDE内部启动的Python进程也无法获取新的PATH配置。操作时需从任务管理器中彻底结束所有IDE关联进程，再重新启动IDE加载新的环境变量。
• 清理MikTeX残留的系统注册表路径
  打开Windows注册表编辑器，定位到HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths，查找目录下关联MikTeX的latex、dvipng相关条目，删除对应路径已失效的条目，避免Matplotlib从注册表读取到错误的可执行文件路径。

验证方式 #

配置完成后运行最小测试代码，确认是否可正常生成带LaTeX公式的图片：

fig, ax = plt.subplots()
ax.set_title(r"Test LaTeX Render: $\int_a^b f(x)dx = F(b)-F(a)$")
plt.savefig("latex_test.png", dpi=150)

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