如何在Ubuntu系统（Python 3.10.12）中安装wxPython？

1. 先安装系统依赖（核心解决方向） #

wxPython编译依赖大量系统库，缺失依赖是pip安装失败的最常见原因。执行以下命令安装全套必需依赖：

sudo apt update && sudo apt install -y build-essential 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 libbz2-dev libsqlite3-dev

2. 确认Python环境正确性 #

确保当前使用的是目标Python版本：

python3 --version

若版本不符，切换到Python 3.10.12环境（比如用pyenv的话执行pyenv activate 3.10.12）。同时更新pip到最新版本：

python3 -m pip install --upgrade pip

3. 指定兼容版本安装 #

Python 3.10需要wxPython 4.2.0及以上版本，直接指定版本安装：

pip install wxPython==4.2.1

若仍失败，关闭pip的构建隔离模式，让其直接调用系统已装依赖：

pip install wxPython==4.2.1 --no-build-isolation

4. 尝试预编译wheel包（跳过编译环节） #

如果编译过程超时或报错，可直接下载对应架构的预编译wheel包安装：

1. 找到适配Python 3.10、Ubuntu x86_64的wheel包（如wxPython-4.2.1-cp310-cp310-linux_x86_64.whl）
2. 执行本地安装：

pip install /path/to/your/wxPython-wheel-file.whl

额外排查方案 #

• 若报错提示内存不足，可临时增加swap空间：

  sudo fallocate -l 2G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile
  

• 若提示某个具体库缺失，直接用apt install安装对应库即可。

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