全面解析 wxPython：构建原生桌面应用的 Python GUI 框架

原创于 2025-07-10 15:28:35 发布 · 1.3k 阅读

23 ·

CC 4.0 BY-SA版权

文章标签：

#python #开发语言 #wxPython

python基础到进阶教程专栏收录该内容

208 篇文章

订阅专栏

一、引言

在 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()