一、引言
在 GUI 编程的世界中，Python 作为一门简洁高效的语言，有多种可选的图形界面库。除了 PyQt 和 Tkinter 外，wxPython 是一款历史悠久、跨平台且极具原生风格的 GUI 框架。
wxPython 封装了流行的 C++ GUI 框架 wxWidgets，允许 Python 开发者以面向对象的方式快速开发跨平台桌面应用程序。它在 Windows、macOS 和 Linux 上表现一致，并且使用系统原生控件，拥有良好的平台兼容性和用户体验。
本文将全面介绍 wxPython，从基础知识、安装配置，到核心组件、事件机制、布局系统、实际项目，带你深入了解这个强大的 GUI 框架。
二、wxPython 概述
2.1 什么是 wxPython？
wxPython 是 Python 对 wxWidgets 的封装，允许用 Python 构建功能强大且平台原生的图形界面程序。wxPython 自上世纪 90 年代末诞生至今，已成为 Python GUI 编程的重要力量。
其特点包括：
使用原生控件，拥有平台一致的 UI 外观；支持绝大部分桌面控件；完善的事件机制与布局管理；社区活跃、文档丰富、稳定性高；免费开源，基于 LGPL 协议发布。
2.2 wxPython 与其他 GUI 框架对比
框架原生风格学习曲线功能丰富度是否开源推荐使用场景Tkinter否简单一般是入门、教学、小工具PyQt5否（自绘）中等极为丰富否（GPL）商业应用、高定制需求wxPython是中等丰富是企业工具、跨平台桌面
三、wxPython 安装与入门
3.1 安装 wxPython
使用 pip 安装：
pip install -U wxPython
如遇编译问题，建议使用 Python 官方版本，并在 Windows 上使用 wheel 包安装：
pip install wxPython‑4.x.x‑cp39‑cp39‑win_amd64.whl
3.2 第一个 wxPython 程序
import wx
app = wx.App()
frame = wx.Frame(None, title="Hello wxPython", size=(300, 200))
panel = wx.Panel(frame)
text = wx.StaticText(panel, label="Hello, wxPython!", pos=(90, 80))
frame.Show()
app.MainLoop()
程序运行后会弹出一个窗口，显示“Hello, wxPython!”。
四、wxPython 框架结构与核心类
wxPython 基于事件驱动编程，主要由以下结构组成：
App：整个应用程序的对象。Frame：窗口容器，是顶级窗口。Panel：放置控件的面板，便于布局。Sizers：布局管理器，用于管理控件位置和大小。Events：所有交互事件处理系统。Widgets：常见控件，如 Button、TextCtrl、CheckBox 等。
wxPython 的类名与 wxWidgets 相同，前缀为 wx.，比如：
wx.Frame：主窗口wx.Panel：面板wx.BoxSizer：水平/垂直布局wx.Button：按钮wx.TextCtrl：输入框
五、常用控件详解
wxPython 提供了大量可用控件，满足各种桌面应用需求：
5.1 标签与按钮
label = wx.StaticText(panel, label="用户名：", pos=(20, 20))
button = wx.Button(panel, label="登录", pos=(120, 80))
5.2 文本输入框
textctrl = wx.TextCtrl(panel, pos=(100, 20), size=(160, -1))
5.3 单选框、复选框
radio1 = wx.RadioButton(panel, label="男", pos=(20, 60))
check1 = wx.CheckBox(panel, label="我同意协议", pos=(20, 100))
5.4 列表框、下拉框
listbox = wx.ListBox(panel, choices=["Python", "C++", "Java"], pos=(20, 140))
combo = wx.ComboBox(panel, choices=["微信", "支付宝"], pos=(200, 140))
5.5 菜单栏与工具栏
menubar = wx.MenuBar()
file_menu = wx.Menu()
file_menu.Append(wx.ID_OPEN, '打开')
file_menu.Append(wx.ID_EXIT, '退出')
menubar.Append(file_menu, '&文件')
frame.SetMenuBar(menubar)
六、布局管理（Sizers）
wxPython 强烈建议使用 Sizers 管理布局，而非手动设置控件坐标。
6.1 BoxSizer（垂直/水平）
vbox = wx.BoxSizer(wx.VERTICAL)
vbox.Add(wx.StaticText(panel, label="账号："), flag=wx.LEFT | wx.TOP, border=10)
vbox.Add(wx.TextCtrl(panel), flag=wx.EXPAND | wx.LEFT | wx.RIGHT, border=10)
6.2 GridSizer（网格）
gridsizer = wx.GridSizer(rows=2, cols=2, hgap=5, vgap=5)
gridsizer.AddMany([
(wx.Button(panel, label="按钮1"), 0, wx.EXPAND),
(wx.Button(panel, label="按钮2"), 0, wx.EXPAND)
])
6.3 FlexGridSizer（可伸缩）
用于不同尺寸控件的网格布局，行列可自适应拉伸。
七、事件处理机制
wxPython 使用事件绑定机制（Event Binding）来响应用户操作。
7.1 事件绑定方式
button.Bind(wx.EVT_BUTTON, self.on_click)
7.2 自定义事件处理函数
def on_click(self, event):
wx.MessageBox("按钮被点击！", "提示", wx.OK | wx.ICON_INFORMATION)
7.3 常见事件类型
事件名称说明wx.EVT_BUTTON按钮点击事件wx.EVT_TEXT文本框内容变化事件wx.EVT_CLOSE关闭窗口事件wx.EVT_CHECKBOX复选框事件wx.EVT_RADIOBUTTON单选按钮事件
八、高级功能与组件
8.1 多文档界面（MDI）
class MyMDIFrame(wx.MDIParentFrame):
def __init__(self):
super().__init__(None, title="MDI 示例")
child = wx.MDIChildFrame(self, -1, "子窗口")
8.2 状态栏与工具栏
frame.CreateStatusBar()
toolbar = frame.CreateToolBar()
toolbar.AddTool(wx.ID_ANY, '工具1', wx.ArtProvider.GetBitmap(wx.ART_NEW))
toolbar.Realize()
8.3 文件对话框
with wx.FileDialog(self, "打开文件", wildcard="*.txt", style=wx.FD_OPEN) as dlg:
if dlg.ShowModal() == wx.ID_OK:
path = dlg.GetPath()
九、实际项目：记事本应用
9.1 基础功能
菜单栏：打开、保存、退出编辑区域：多行文本编辑状态栏：显示状态信息
9.2 实现代码示例
class Notepad(wx.Frame):
def __init__(self):
super().__init__(None, title="记事本", size=(500, 400))
self.text = wx.TextCtrl(self, style=wx.TE_MULTILINE)
self.CreateStatusBar()
self.build_menu()
def build_menu(self):
menubar = wx.MenuBar()
file_menu = wx.Menu()
file_menu.Append(wx.ID_OPEN, "打开")
file_menu.Append(wx.ID_SAVE, "保存")
file_menu.Append(wx.ID_EXIT, "退出")
menubar.Append(file_menu, "文件")
self.SetMenuBar(menubar)
self.Bind(wx.EVT_MENU, self.on_open, id=wx.ID_OPEN)
self.Bind(wx.EVT_MENU, self.on_save, id=wx.ID_SAVE)
self.Bind(wx.EVT_MENU, self.on_exit, id=wx.ID_EXIT)
def on_open(self, event):
with wx.FileDialog(self, "打开文件", wildcard="*.txt", style=wx.FD_OPEN) as dlg:
if dlg.ShowModal() == wx.ID_OK:
with open(dlg.GetPath(), 'r') as f:
self.text.SetValue(f.read())
def on_save(self, event):
with wx.FileDialog(self, "保存文件", wildcard="*.txt", style=wx.FD_SAVE) as dlg:
if dlg.ShowModal() == wx.ID_OK:
with open(dlg.GetPath(), 'w') as f:
f.write(self.text.GetValue())
def on_exit(self, event):
self.Close()
十、部署与打包
可以使用 pyinstaller 将 wxPython 应用打包为独立可执行文件：
pyinstaller -F -w your_script.py
选项说明：
-F：单文件打包-w：无控制台窗口
对于图标资源和配置文件，可通过 --add-data 参数打包进去。
十一、wxPython 优缺点与应用场景
11.1 优点
使用原生控件，界面风格符合平台习惯开源、免费、社区活跃API 类似 C++，适合转 Qt/Wx 项目者稳定性高，跨平台一致性强
11.2 缺点
文档略显陈旧控件样式不易自定义学习曲线稍高于 Tkinter
11.3 适合项目类型
企业级桌面软件工具类应用（批处理工具、文件管理器）教学平台（考试系统、练习评测器）嵌入式设备前端界面
十二、总结与推荐学习路线
本文从基础入门到实际应用，全面介绍了 wxPython 的开发流程与能力。你已经了解了如何使用 wxPython 创建原生 GUI 窗口，布置控件，处理事件，以及打包发布程序。
推荐学习路径：
理解窗口与控件的关系（Frame、Panel、TextCtrl）熟悉布局管理器（BoxSizer、GridSizer）掌握事件绑定与处理机制尝试做一个完整的项目，如记事本、文件管理器学习 wx.lib 库的扩展组件（如 wx.lib.agw）
推荐资源：
官方文档：https://wxpython.org示例合集：https://github.com/wxWidgets/Phoenix实践项目教程：wxGlade + Python