Ubuntu虚拟机中无法安装wxPython Python包的技术求助

问题原因 #

collections.Mapping在Python 3.10及以上版本中已被移除，迁移至collections.abc.Mapping。如果你的Ubuntu虚拟机安装的是Python 3.10+，而尝试安装的wxPython版本不兼容该Python版本，就会触发这个报错。

解决方案 #

• 第一步：检查当前Python版本
  执行命令确认Python版本：

  python3 --version
  

  如果输出是3.10及以上版本，按以下方法处理：

• 方法1：安装兼容高版本Python的wxPython
  直接指定兼容Python 3.10+的wxPython版本安装，例如：

  pip install wxPython==4.2.0
  

  （4.2.0及后续版本均支持Python 3.10+）

• 方法2：降级Python到3.9及以下版本
  若需使用旧版wxPython，可安装Python 3.9并通过虚拟环境隔离：

  1. 安装Python 3.9依赖：

     sudo apt-get update && sudo apt-get install python3.9 python3.9-venv python3.9-dev
     

  2. 创建并激活虚拟环境：

     python3.9 -m venv wx_env
     source wx_env/bin/activate
     

  3. 安装wxPython：

     pip install wxPython
     

• 额外检查：安装系统依赖
  若上述方法仍失败，先安装wxPython编译所需的系统依赖：

  sudo apt-get install libgtk-3-dev libwebkit2gtk-4.0-dev libjpeg-dev libtiff-dev libsdl2-dev libgstreamer-plugins-base1.0-dev libnotify-dev freeglut3-dev libsm-dev libssl-dev libcurl4-openssl-dev libxtst-dev
  

  之后再尝试安装wxPython。

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