wxPython在Windows上的安装与使用指南

一、wxPython是什么？为什么选择它？

如果你正在寻找一个在Windows上创建桌面应用程序的Python工具包，wxPython绝对值得考虑。这是一个基于wxWidgets C++库的Python封装，让你能够用Python语言编写出具有原生Windows外观和感觉的图形界面程序。

与其他GUI工具包相比，wxPython有几个明显优势：

完全免费开源，商用也无须担心授权问题
生成的程序外观与Windows原生应用几乎一致
支持跨平台，同一份代码稍作调整即可在Linux、macOS上运行
文档相对完善，社区活跃，遇到问题容易找到解决方案

二、Windows环境下安装wxPython

方法一：通过pip安装（推荐）

这是最简单直接的方法，适合大多数用户：

打开命令提示符
- 按下Win + R键
- 输入cmd，然后按回车
检查Python是否已安装
```
python --version
```
如果显示Python版本号（如Python 3.9.0），说明已安装；如果提示“不是内部或外部命令”，需要先安装Python

安装wxPython

pip install wxPython

如果网络较慢，可以使用国内镜像源加速：

pip install wxPython -i https://pypi.tuna.tsinghua.edu.cn/simple

方法二：手动下载安装包

如果pip安装失败，可以手动下载：

访问wxPython官方网站
找到与你的Python版本和系统架构（32位或64位）匹配的whl文件
下载后，在文件所在目录打开命令提示符，执行：
```
pip install 文件名.whl
```

常见安装问题解决

问题1：提示“pip不是内部或外部命令”

解决方案：将Python的Scripts目录添加到系统环境变量PATH中
步骤：
1. 找到Python安装目录下的Scripts文件夹（如C:\Python39\Scripts）
2. 右键点击“此电脑”→属性→高级系统设置→环境变量
3. 在“系统变量”中找到Path，点击编辑
4. 新建，粘贴Scripts文件夹路径

问题2：安装过程中报错

确保Python版本与wxPython版本兼容
尝试以管理员身份运行命令提示符
更新pip工具：python -m pip install --upgrade pip

三、第一个wxPython程序：从零开始

安装成功后，我们来创建一个最简单的窗口程序：

import wx

class MyFrame(wx.Frame):
    def __init__(self):
        super().__init__(parent=None, title='我的第一个wxPython程序', size=(400, 300))

        # 创建一个面板
        panel = wx.Panel(self)

        # 创建文本标签
        static_text = wx.StaticText(panel, label="你好，wxPython！", pos=(100, 50))

        # 创建按钮
        my_button = wx.Button(panel, label="点击我", pos=(150, 100))

        # 绑定按钮点击事件
        my_button.Bind(wx.EVT_BUTTON, self.on_button_click)

        # 显示窗口
        self.Show()

    def on_button_click(self, event):
        # 创建消息对话框
        wx.MessageBox("你点击了按钮！", "提示", wx.OK | wx.ICON_INFORMATION)

if __name__ == "__main__":
    app = wx.App()      # 创建应用程序对象
    frame = MyFrame()   # 创建窗口对象
    app.MainLoop()      # 进入主事件循环

保存和运行步骤：

打开记事本或任何代码编辑器
复制上面的代码
保存为first_app.py（注意后缀是.py）
双击运行，或在命令提示符中输入：python first_app.py

四、实际应用：创建一个简易记事本

下面我们创建一个稍微实用一点的程序——简易记事本：

import wx

class SimpleNotepad(wx.Frame):
    def __init__(self):
        super().__init__(parent=None, title='简易记事本', size=(600, 400))

        # 创建菜单栏
        menubar = wx.MenuBar()

        # 文件菜单
        file_menu = wx.Menu()
        new_item = file_menu.Append(wx.ID_NEW, "新建\tCtrl+N")
        open_item = file_menu.Append(wx.ID_OPEN, "打开\tCtrl+O")
        save_item = file_menu.Append(wx.ID_SAVE, "保存\tCtrl+S")
        file_menu.AppendSeparator()
        exit_item = file_menu.Append(wx.ID_EXIT, "退出\tCtrl+Q")

        menubar.Append(file_menu, "文件")

        # 编辑菜单
        edit_menu = wx.Menu()
        edit_menu.Append(wx.ID_COPY, "复制\tCtrl+C")
        edit_menu.Append(wx.ID_PASTE, "粘贴\tCtrl+V")
        edit_menu.Append(wx.ID_CUT, "剪切\tCtrl+X")

        menubar.Append(edit_menu, "编辑")

        self.SetMenuBar(menubar)

        # 创建文本编辑区域
        self.text_ctrl = wx.TextCtrl(self, style=wx.TE_MULTILINE)

        # 绑定菜单事件
        self.Bind(wx.EVT_MENU, self.on_new, new_item)
        self.Bind(wx.EVT_MENU, self.on_open, open_item)
        self.Bind(wx.EVT_MENU, self.on_save, save_item)
        self.Bind(wx.EVT_MENU, self.on_exit, exit_item)

        # 创建状态栏
        self.CreateStatusBar()
        self.SetStatusText("就绪")

        self.Show()

    def on_new(self, event):
        self.text_ctrl.Clear()
        self.SetStatusText("新建文件")

    def on_open(self, event):
        # 创建文件对话框
        with wx.FileDialog(self, "打开文件", wildcard="文本文件 (*.txt)|*.txt",
                          style=wx.FD_OPEN | wx.FD_FILE_MUST_EXIST) as dialog:

            if dialog.ShowModal() == wx.ID_CANCEL:
                return

            # 读取文件内容
            filepath = dialog.GetPath()
            with open(filepath, 'r', encoding='utf-8') as file:
                self.text_ctrl.SetValue(file.read())

            self.SetStatusText(f"已打开: {filepath}")

    def on_save(self, event):
        with wx.FileDialog(self, "保存文件", wildcard="文本文件 (*.txt)|*.txt",
                          style=wx.FD_SAVE | wx.FD_OVERWRITE_PROMPT) as dialog:

            if dialog.ShowModal() == wx.ID_CANCEL:
                return

            # 保存文件
            filepath = dialog.GetPath()
            with open(filepath, 'w', encoding='utf-8') as file:
                file.write(self.text_ctrl.GetValue())

            self.SetStatusText(f"已保存到: {filepath}")

    def on_exit(self, event):
        self.Close()

if __name__ == "__main__":
    app = wx.App()
    frame = SimpleNotepad()
    app.MainLoop()

五、wxPython进阶技巧

1. 界面布局管理

新手常犯的错误是使用绝对坐标定位控件，这在不同分辨率下会显示异常。推荐使用sizer进行布局：

import wx

class SizerExample(wx.Frame):
    def __init__(self):
        super().__init__(parent=None, title='布局示例', size=(400, 300))

        panel = wx.Panel(self)

        # 创建垂直排列的sizer
        vbox = wx.BoxSizer(wx.VERTICAL)

        # 第一行：标签和文本框
        hbox1 = wx.BoxSizer(wx.HORIZONTAL)
        label1 = wx.StaticText(panel, label="用户名:")
        text1 = wx.TextCtrl(panel)
        hbox1.Add(label1, proportion=0, flag=wx.ALL, border=5)
        hbox1.Add(text1, proportion=1, flag=wx.EXPAND|wx.ALL, border=5)

        # 第二行：标签和文本框
        hbox2 = wx.BoxSizer(wx.HORIZONTAL)
        label2 = wx.StaticText(panel, label="密码:")
        text2 = wx.TextCtrl(panel, style=wx.TE_PASSWORD)
        hbox2.Add(label2, proportion=0, flag=wx.ALL, border=5)
        hbox2.Add(text2, proportion=1, flag=wx.EXPAND|wx.ALL, border=5)

        # 按钮行
        hbox3 = wx.BoxSizer(wx.HORIZONTAL)
        btn_ok = wx.Button(panel, label="确定")
        btn_cancel = wx.Button(panel, label="取消")
        hbox3.Add(btn_ok, proportion=0, flag=wx.ALL, border=5)
        hbox3.Add(btn_cancel, proportion=0, flag=wx.ALL, border=5)

        # 将所有行添加到垂直sizer
        vbox.Add(hbox1, proportion=0, flag=wx.EXPAND|wx.ALL, border=10)
        vbox.Add(hbox2, proportion=0, flag=wx.EXPAND|wx.ALL, border=10)
        vbox.Add(hbox3, proportion=0, flag=wx.ALIGN_CENTER|wx.TOP|wx.BOTTOM, border=10)

        panel.SetSizer(vbox)
        self.Show()

2. 打包成exe文件

想让别人不用安装Python也能运行你的程序？可以使用PyInstaller打包：

安装PyInstaller
```
pip install pyinstaller
```
打包程序
```
pyinstaller -F -w your_program.py
```
- -F：打包成单个exe文件
- -w：不显示命令行窗口（适合GUI程序）
处理wxPython打包的特殊问题 wxPython打包时可能会缺少资源文件，需要手动指定：
```
pyinstaller -F -w --add-data "venv/Lib/site-packages/wx;wx" your_program.py
```
（注意：venv/Lib/site-packages/wx需要替换为你的实际路径）