conda环境下module ‘backend_interagg‘ has no attribute ‘FigureCanvas‘问题解决

1 问题描述

在pycharm下，使用conda环境运行模型程序，调用matplotlib绘制图形，出现如下错误：

Traceback (most recent call last):
  File "D:\code\cv\vgg16_cifar10.py", line 173, in <module>
    plt.xlabel('times')
  File "C:\Users\Admin\.conda\envs\pt\lib\site-packages\matplotlib\pyplot.py", line 4135, in xlabel
    return gca().set_xlabel(
  File "C:\Users\Admin\.conda\envs\pt\lib\site-packages\matplotlib\pyplot.py", line 2525, in gca
    return gcf().gca()
  File "C:\Users\Admin\.conda\envs\pt\lib\site-packages\matplotlib\pyplot.py", line 1000, in gcf
    return figure()
  File "C:\Users\Admin\.conda\envs\pt\lib\site-packages\matplotlib\pyplot.py", line 934, in figure
    manager = new_figure_manager(
  File "C:\Users\Admin\.conda\envs\pt\lib\site-packages\matplotlib\pyplot.py", line 464, in new_figure_manager
    _warn_if_gui_out_of_main_thread()
  File "C:\Users\Admin\.conda\envs\pt\lib\site-packages\matplotlib\pyplot.py", line 441, in _warn_if_gui_out_of_main_thread
    canvas_class = cast(type[FigureCanvasBase], _get_backend_mod().FigureCanvas)
  File "C:\Users\Admin\.conda\envs\pt\lib\site-packages\matplotlib\pyplot.py", line 280, in _get_backend_mod
    switch_backend(rcParams._get("backend"))  # type: ignore[attr-defined]
  File "C:\Users\Admin\.conda\envs\pt\lib\site-packages\matplotlib\pyplot.py", line 343, in switch_backend
    canvas_class = module.FigureCanvas
AttributeError: module 'backend_interagg' has no attribute 'FigureCanvas'

2 问题分析

从错误中可以看出，模块中backend_interagg没有FigureCanvas属性。

查看当前的matplotlib版本：

(pt) PS D:\code\cv> pip list                       
Package             Version
------------------- ------------
certifi             2022.12.7
charset-normalizer  2.1.1
contourpy           1.2.0
cycler              0.12.1
filelock            3.9.0
fonttools           4.47.0
fsspec              2023.4.0
idna                3.4
importlib-resources 6.1.1
Jinja2              3.1.2
kiwisolver          1.4.5
MarkupSafe          2.1.3
matplotlib          3.8.2
mpmath              1.3.0
networkx            3.0
numpy               1.24.1
packaging           23.2
Pillow              9.3.0
pip                 23.3.1
pyparsing           3.1.1
python-dateutil     2.8.2
requests            2.28.1
setuptools          68.2.2
six                 1.16.0
sympy               1.12
torch               2.1.2+cu118
torchaudio          2.1.2+cu118
torchvision         0.16.2+cu118
typing_extensions   4.4.0
urllib3             1.26.13
wheel               0.41.2
zipp                3.17.0

当前matplotlib版本为3.8.2 。

3 问题解决

3.1 解决方案1：更改pycharm配置

在pycharm的setting-->Tools-->Python Scientific中去掉“show plots in tool window”的勾选

修改后的配置如下：

再次运行程序，绘制图形正常显示，不再报错。

3.2 解决方案2：matplotlib切换图形界面显示终端TkAgg

在使用matplotlib的python文件中增加两行代码，如下所示：

import matplotlib
matplotlib.use('TkAgg')

通过代码配置，matplotlib图形界面显示终端切换为TkAgg，再次运行，绘制图形正常，不再报错。

3.3 解决方案3：降低matplotlib版本

pip install matplotlib==3.5.0

再次运行，绘制图形正常，不再报错。

 4 conda环境介绍

Conda是一个开源的包管理器和环境管理系统，用于安装、运行和更新包和其依赖项。它是由Anaconda, Inc.（以前称为Continuum Analytics）创建，用于支持Python程序开发，但它也可以用来管理来自其他语言的包。Conda使得包管理和环境隔离变得简单，对于处理多个项目中的依赖关系和版本控制尤其有用。

Conda是一个强大的工具，对于管理复杂的Python项目和环境至关重要。它简化了包管理和环境设置，使得Python开发更加容易和高效。通过使用Conda，开发者可以确保他们的项目在不同机器和操作系统上都能以相同的方式运行，大大提高了项目的可移植性和可复现性。

4.1 Conda的核心功能

• 包管理：Conda作为包管理器，可以安装、更新和移除Python包。它通过Conda仓库，如Anaconda Cloud或Conda Forge，来获取包。

• 环境管理：Conda允许用户创建隔离的环境，以便于不同项目可以拥有不同的库和/或Python版本。这在处理不兼容的依赖项或不同项目的需求时非常有用。

• 跨平台：Conda支持Linux、OS X和Windows，并允许创建跨平台的Python环境。

• 开源：Conda是开源的，允许用户查看源代码并对其进行改进。

4.2 使用Conda的优势

• 解决依赖性问题：Conda可以自动解决包之间的依赖关系，简化了安装过程。

• 环境隔离：创建独立的环境可以避免包之间的版本冲突，使得项目更稳定。

• 易于使用：Conda的命令行界面简单直观，易于学习和使用。

• 广泛的包支持：Conda支持Python的许多流行库和应用程序。

• 社区支持：作为一个流行的工具，Conda拥有一个活跃的社区，用户可以从中找到支持和资源。

4.3 Conda环境的创建和管理

• 创建新环境：使用conda create命令创建一个新环境，可以指定Python版本和所需的包。

• 激活环境：使用conda activate命令来激活环境。

• 安装包：在激活的环境中使用conda install命令来安装新的包。

• 环境列表：使用conda env list来查看所有可用的Conda环境。

• 移除环境：使用conda env remove命令来移除不再需要的环境。

4.4 应用场景

• 数据科学和机器学习：Conda非常适合于数据科学和机器学习项目，这些项目通常需要多个库和框架。

• 软件开发：软件开发者使用Conda来管理项目依赖，确保一致的开发环境。

• 教学和学术研究：教师和研究人员使用Conda来创建具有特定库和工具的环境，用于教学和研究。

4.5 常用命令

Conda 是一个开源的包管理器和环境管理器，广泛用于管理Python环境和包。以下是一些常用的 Conda 命令：

• 安装 Conda 包:

  • conda install [package-name]: 安装指定的包。

• 创建和管理环境:

  • conda create --name [env-name]: 创建一个新的环境。
  • conda activate [env-name]: 激活指定环境。
  • conda deactivate: 退出当前环境。
  • conda env list: 列出所有可用的环境。

• 管理包:

  • conda list: 在当前环境中列出所有已安装的包。
  • conda update [package-name]: 更新指定的包。
  • conda remove [package-name]: 移除指定的包。

• 搜索包:

  • conda search [package-name]: 搜索可用的包版本。

• 环境导出和导入:

  • conda env export > environment.yml: 导出当前环境的配置到一个YAML文件。
  • conda env create -f environment.yml: 使用YAML文件创建一个新环境。

• 更新 Conda:

  • conda update conda: 更新 Conda 到最新版本。

• 查看 Conda 信息:

  • conda info: 显示关于 Conda 的信息。