wxPython报错：模块‘wx’未完全初始化无‘Frame’属性，求因及解决

问题描述 #

我正在编写一个基于wxPython的小型Python程序，代码如下：

import wx
class MyFrame(wx.Frame):
    def __init__(self):
        super().__init__(parent=None, title='Hello World')
        panel = wx.Panel(self)
        self.text_ctrl = wx.TextCtrl(panel, pos=(5, 5))
        my_btn = wx.Button(panel, label='Press Me', pos=(5, 55))
        self.Show()
if __name__ == '__main__':
    app = wx.App()
    frame = MyFrame()
    app.MainLoop()

运行后返回错误，报错信息如下：

Traceback (most recent call last):
  File "/home/float/.local/lib/python3.8/site-packages/wx/__init__.py", line 1, in <module>
    import wx
  File "/home/float/.local/lib/python3.8/site-packages/wx/__init__.py", line 3, in <module>
    class MyFrame(wx.Frame):
AttributeError: partially initialized module 'wx' has no attribute 'Frame' (most likely due to a circular import)
Error in sys.excepthook:
Traceback (most recent call last):
  File "/usr/lib/python3/dist-packages/apport_python_hook.py", line 72, in apport_excepthook
    from apport.fileutils import likely_packaged, get_recent_crashes
  File "/usr/lib/python3/dist-packages/apport/__init__.py", line 5, in <module>
    from apport.report import Report
  File "/usr/lib/python3/dist-packages/apport/report.py", line 15, in <module>
    import xml.dom, xml.dom.minidom
  File "/home/float/.local/lib/python3.8/site-packages/wx/xml.py", line 13, in <module>
    from ._xml import *
ImportError: attempted relative import with no known parent package
Original exception was:
Traceback (most recent call last):
  File "/home/float/.local/lib/python3.8/site-packages/wx/__init__.py", line 1, in <module>
    import wx
  File "/home/float/.local/lib/python3.8/site-packages/wx/__init__.py", line 3, in <module>
    class MyFrame(wx.Frame):
AttributeError: partially initialized module 'wx' has no attribute 'Frame' (most likely due to a circular import)

我未在自己的程序中发现循环导入，因此怀疑该错误来自wxPython库，请问该假设是否正确？如何解决此问题？我在WSL2（Ubuntu 20）环境下运行程序。

补充：已通过执行pip3 install --upgrade --force-reinstall wxPython解决问题，但想了解该问题出现的原因。

问题分析与结论 #

你的假设是完全正确的——这个错误和你的代码逻辑无关，根源出在wxPython库本身的安装问题上。你的代码没有任何循环导入的问题，从报错堆栈可以清晰看到，错误发生在wx库内部的导入流程中，而非你的代码逻辑。

错误原因详解 #

这个异常通常由以下几种场景导致：

• 库文件损坏：wxPython的核心模块（比如wx.Frame所属的底层模块）在安装或使用过程中被意外损坏、缺失，导致Python导入时无法找到对应的属性，进而触发了"循环导入"的误导性提示。
• 不完整的安装：之前的wxPython安装过程可能被中断（比如网络问题、权限不足），导致部分依赖子模块（如报错中提到的wx._xml）没有正确部署，引发相对导入失败。
• 环境路径冲突：在WSL2 Ubuntu 20环境下，系统自带的Python包与你通过pip安装的wxPython可能存在版本冲突，或者虚拟环境配置异常，导致Python加载了错误的wx模块文件，打乱了正常的导入顺序。

解决方法的有效性说明 #

你使用的pip3 install --upgrade --force-reinstall wxPython命令之所以能解决问题，核心原因在于：

• --force-reinstall会强制卸载现有损坏的wxPython实例，重新下载并安装完整、未损坏的库文件，修复了所有缺失或损坏的模块。
• --upgrade确保你安装了与WSL2 Ubuntu 20环境兼容的最新wxPython版本，避免了旧版本的适配问题。

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