matplotlib报错：'transform'必须为matplotlib.transform.Transform实例求助

我之前用Matplotlib绘图时也碰到过一模一样的问题——代码没语法报错，但一运行就弹出这个值错误，咱们一步步来排查解决：

先明确你遇到的错误信息：

ERROR value error 'transform' must be an instance of 'matplotlib.transform.Transform'

回溯信息（简化后）：

Traceback (most recent call last):
File "<ipython-input-7-d2d08b3c451f>", line 1, in <module>
runfile('.../plottest.py', wdir='.../ProgsForSteve')
File "C:\Users\anwar\Anaconda3\lib\site-packages\spyder\utils\site\sitecustomize.py", line 705, in runf...

可能的原因和对应解决方法 #

• 错误的参数传递：这是最常见的问题。你肯定在某个Matplotlib函数（比如text()、annotate()这类）里，给transform参数传了非Transform实例的值——比如字符串、数字、自定义普通对象，而不是Matplotlib提供的合法Transform对象（比如ax.transData、ax.transAxes、fig.transFigure这些）。
  解决：找到所有用到transform参数的代码行，把参数替换成Matplotlib的Transform实例。比如把plt.text(1,1,"test",transform="axes")改成plt.text(1,1,"test",transform=ax.transAxes)。

• 变量名冲突：如果你自己定义了一个叫transform的变量（比如transform = "my_setting"或者transform = 123），会覆盖Matplotlib内部的相关对象，导致后续调用函数时出错。
  解决：搜索你的代码，把自定义的transform变量改成别的名字，比如my_transform。

• 版本兼容问题：如果你的Matplotlib版本太旧，可能存在一些transform相关的bug，或者你参考的教程是基于旧版本API，和当前版本不兼容。
  解决：更新Matplotlib到最新稳定版。如果用pip，运行：

  pip install --upgrade matplotlib
  

  如果用conda环境，运行：

  conda update matplotlib
  

正确使用transform的示例代码 #

给你一个简单的正确示例参考：

import matplotlib.pyplot as plt

# 创建画布和坐标轴
fig, ax = plt.subplots(figsize=(6,4))
ax.plot([0,1,2], [0,2,1])

# 使用坐标轴坐标系的transform（0-1范围对应坐标轴的宽高）
ax.text(0.5, 0.5, "坐标轴中心", transform=ax.transAxes, fontsize=12)
# 使用数据坐标系的transform
ax.text(1, 1.5, "数据点(1,1.5)", transform=ax.transData, color="red")

plt.show()

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