Visual Studio Code中安装wxPython失败求助

针对distutils.errors.DistutilsPlatformError: Unable to find vcvarsall.bat错误（安装wxPython==4.1.1时） #

• 该错误源于Windows环境缺少对应版本的C构建工具，wxPython 4.1.1依赖VS 2019的MSVC v142工具集。安装Visual Studio Build Tools 2019，勾选「C构建工具」组件，确保包含MSVC v142工具集和对应版本的Windows SDK。
• 安装完成后重启VS Code，在终端重新执行：

  pip install wxPython==4.1.1
  

• 若不想安装完整构建工具，可下载对应Python版本（匹配系统位数）的wxPython预编译wheel包，直接通过本地文件安装：

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

针对ImportError: cannot import name 'Mapping' from 'collections'错误（安装最新版wxPython时） #

• 此问题是Python 3.10+移除了collections.Mapping（移至collections.abc.Mapping），而旧版wxPython未适配该变更导致。
• 若使用Python 3.10及以上版本，安装wxPython 4.2.0及以上的稳定版（已修复该兼容性问题）：

  pip install wxPython>=4.2.0
  

• 若需保留现有Python版本，也可降级Python至3.9版本后再安装最新版wxPython。

通用排查步骤 #

• 先升级pip到最新版本：

  pip install --upgrade pip
  

• 若使用虚拟环境，确保终端已激活目标虚拟环境，避免全局环境依赖干扰。

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