导入kivy.garden.matplotlib的FigureCanvasKivyAgg提示引用报错

报错信息：Cannot find reference 'matplotlib' in 'init.py'

这个报错通常由kivy garden组件的安装方式错误、IDE静态路径识别异常两类原因导致，可按以下步骤逐一排查：

• 首先修正garden matplotlib的安装方式，很多时候通过pip直接安装的预编译包会存在路径映射问题，先执行卸载命令：
  pip uninstall kivy-garden kivy-garden-matplotlib -y
  重装基础garden工具：
  pip install kivy-garden
  再通过garden官方命令安装matplotlib组件：
  garden install matplotlib
• 如果执行完上述步骤后，仅IDE（如PyCharm、VS Code）有报错提示、实际运行代码无导入错误，属于IDE静态检查的路径识别缺陷，手动添加路径标记即可消除提示：
  PyCharm操作：找到Python环境目录下的site-packages/kivy/garden文件夹，右键选择「Mark Directory as」→「Sources Root」
  VS Code操作：在项目.vscode/settings.json中添加如下配置，把路径替换为你本地的garden目录实际路径：

  {
    "python.analysis.extraPaths": ["你的本地路径/site-packages/kivy/garden"]
  }
  

• 如果仍存在运行时导入错误，替换原有导入语句为显式加载写法：

  import kivy.garden
  kivy.garden.require("matplotlib")
  from kivy.garden.matplotlib.backend_kivyagg import FigureCanvasKivyAgg
  

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