Windows 下 Python 安装 wx：从零到可用的完整教程

问题分析

很多人在 Windows 上装 Python 之后，想用 wxPython 做图形界面程序，结果一上来就卡在安装这一步：
要么 pip install wx 找不到包；
要么装了之后导入报错；
要么 Python 版本和 wxPython 不兼容；
要么装完运行时提示缺少依赖。

先说结论：
Windows 下安装 wx，正确的包名通常是 wxPython，不是 wx。
真正开发桌面 GUI 时，大家用得最多的也是 wxPython，它是对 wxWidgets 的 Python 封装。

---

一、先确认你要装的是什么

1. 常见误区：wx 和 wxPython 不是一回事

在 Python 里，很多新手会直接输入：

pip install wx

这个通常不是你要的库。
你真正需要的是：

pip install wxPython

安装成功后，代码里一般这样导入：

import wx

注意这里很容易混淆：
安装包叫 wxPython，导入模块叫 wx。

---

二、安装前准备

1. 确认 Python 版本

wxPython 对 Python 版本有兼容要求。建议优先使用：

• Python 3.9
• Python 3.10
• Python 3.11

如果你是新手，建议直接装一个较稳定的版本，比如 Python 3.10 或 3.11。
不建议一上来就用太新的开发版 Python，容易遇到兼容问题。

2. 确认 Python 是 64 位

wxPython 在 Windows 上通常推荐使用 64 位 Python。
查看方式：

打开命令提示符，输入：

python -c "import platform; print(platform.architecture())"

如果输出里有 64bit，说明是 64 位。

也可以查看 Python 版本：

python --version

---

三、Windows 下安装 wxPython 的标准方法

方法一：直接用 pIP 安装

这是最常用、最省事的方法。

步骤 1：打开命令提示符

按下：

• Win + R
• 输入 cmd
• 回车

步骤 2：升级 pip

先把 pip 升级到新版本，避免下载失败：

python -m pip install --upgrade pip

步骤 3：安装 wxPython

执行：

pip install wxPython

如果你的系统里有多个 Python 版本，建议用：

python -m pip install wxPython

这样更稳，不容易装错环境。

---

四、安装成功后怎么验证

安装完成后，在命令行输入：

python

进入 Python 交互环境后，输入：

import wx
print(wx.version())

如果能正常输出版本号，说明安装成功。

比如可能看到类似：

4.2.1 msw (phoenix) wxWidgets 3.2.2

这就说明 wxPython 可用了。

---

五、如果安装失败，怎么解决

Windows 上装 wxPython，最常见的问题不是命令写错，而是环境不对。下面按常见报错来处理。

1. 提示找不到包或安装失败

比如出现类似：

ERROR: Could not find a version that satisfies the requirement wxPython

这种情况通常是以下原因之一：

原因 A：Python 版本不兼容

比如你装的是特别新的 Python，wxPython 还没完全支持。

解决办法：

• 换用 Python 3.10 或 3.11
• 重新创建环境再安装

原因 B：Python 位数不对

比如你装的是 32 位 Python，某些环境下会更容易出问题。

解决办法：

• 卸载当前 Python
• 安装 64 位版本

原因 C：pip 太旧

旧版 pip 可能找不到正确的 wheel 包。

解决办法：

python -m pip install --upgrade pip setuptools wheel

然后重新执行：

pip install wxPython

---

2. 安装很慢或者卡住

wxPython 包比较大，首次安装下载会比较慢。

解决办法：

• 确保网络稳定
• 换一个网络环境
• 尽量不要用太老的 pip
• 如果公司网络限制较多，可尝试临时切换网络

---

3. 导入时报错 No module named wx

如果你已经安装了，但运行时提示：

ModuleNotFoundError: No module named 'wx'

这通常不是没装成功，而是装到了另一个 Python 环境里。

解决办法 1：确认当前运行的 Python

执行：

where python

再执行：

python -m pip show wxPython

如果 pip show 查不到，说明当前环境里没装。

解决办法 2：用同一个 Python 安装

推荐直接用：

python -m pip install wxPython

不要只写 pip install wxPython，因为 pip 可能指向别的 Python。

---

4. 虚拟环境里装了，系统环境里不能用

如果你用了 venv、Anaconda、PyCharm 虚拟环境，很可能装在环境 A，运行在环境 B。

解决办法：

1. 先激活对应环境
2. 再安装 wxPython

例如 venv：

.\venv\Scripts\activate
pip install wxPython

然后再运行程序。

---

六、推荐的安装方式：创建独立虚拟环境

如果你是做项目，最稳妥的办法是给每个项目单独建一个环境，避免包冲突。

步骤 1：创建虚拟环境

进入项目目录后执行：

python -m venv venv

步骤 2：激活环境

.\venv\Scripts\activate

激活成功后，命令行前面通常会出现 (venv)。

步骤 3：安装 wxPython

pip install --upgrade pip
pip install wxPython

步骤 4：测试

创建一个 test.py 文件，写入：

import wx

app = wx.App(False)
frame = wx.Frame(None, title="Hello wxPython")
frame.Show()
app.MainLoop()

运行：

python test.py

如果弹出一个窗口，说明安装和运行都正常。

---

七、一个最小可运行示例

这是最基础的 wxPython 窗口程序：

import wx

class MyFrame(wx.Frame):
    def __init__(self):
        super().__init__(parent=None, title='wxPython 示例')
        panel = wx.Panel(self)
        text = wx.StaticText(panel, label='Hello wxPython')
        sizer = wx.BoxSizer(wx.VERTICAL)
        sizer.Add(text, 0, wx.ALL | wx.CENTER, 20)
        panel.SetSizer(sizer)
        self.Show()

if __name__ == '__main__':
    app = wx.App(False)
    frame = MyFrame()
    app.MainLoop()

运行后会出现一个简单窗口。
这说明 wxPython 已经可以正常使用了。

---

八、开发时的实用建议

1. 不要混用多个 Python

Windows 上最容易乱的是：

• 系统 Python
• Microsoft Store Python
• Anaconda Python
• PyCharm 自带解释器
• 虚拟环境 Python

建议你固定用一个环境，别来回切换。
新手最稳的做法是：

• 安装官方 Python
• 创建 venv 虚拟环境
• 在环境里安装 wxPython

2. 优先用命令行确认环境

不要只看编辑器显示什么。
真正判断安装成功与否，最靠谱的是在命令行里执行：

python -c "import wx; print(wx.version())"

3. 需要图形界面开发时，记得同步安装配套工具

如果你后面要做界面排版、打包、图标等，常会用到：

• pyinstaller
• pillow
• requests

比如：

pip install pyinstaller pillow requests

---

九、常见问题汇总

问题 1：pip install wx 为什么不行？

因为常用的 Python GUI 库名称是 wxPython，不是 wx。

问题 2：安装后为什么 import wx 报错？

通常是装到了别的 Python 环境里，或者安装没成功。

问题 3：哪个 Python 版本最稳？

建议先用 Python 3.10 / 3.11 64 位。

问题 4：怎么确认装成功？

执行：

python -c "import wx; print(wx.version())"

能输出版本号就成功了。

问题 5：必须用管理员权限安装吗？

一般不需要。
如果只是开发，建议用虚拟环境，别全局乱装。

---

十、推荐的最稳安装流程

如果你想少踩坑，直接按下面做：

方案一：新手稳妥版

1. 安装 Python 3.10/3.11 64 位
2. 打开 cmd
3. 创建虚拟环境：

   python -m venv venv

4. 激活环境：

   .\venv\Scripts\activate

5. 升级工具：

   python -m pip install --upgrade pip setuptools wheel

6. 安装 wxPython：

   pip install wxPython

7. 测试导入：

   python -c "import wx; print(wx.version())"

---

结语

Windows 下安装 Python 的 wx 图形库，核心就一句话：装 wxPython，导入 wx。
只要 Python 版本合适、位数正确、环境不混乱，基本都能一次装好。
如果后续要开发桌面程序，建议直接使用虚拟环境管理项目依赖，这样最省心，也最不容易出错。