PyInstaller打包WxPython GUI跨设备按钮与静态线条颜色不一致求助

问题说明 #

用PyInstaller打包WxPython GUI程序后，目标设备上按钮、静态线条的显示颜色与源设备存在明显差异：源设备上控件有预设的默认及悬停状态颜色，其他设备显示的颜色完全不符合预期。已排查打包日志、warn-myapp.txt、myapp.spec及requirements.txt，怀疑requirements.txt中冗余的PyQt5依赖是诱因（程序基于WxPython开发，无需Qt环境），但尚未找到有效解决办法。

源设备配置 #

Windows-10-10.0.19044-SP0
python 3.9.12 
pyinstaller 5.13.0 
wxPython-4.2.1-cp39-cp39-win_amd64.whl

打包步骤 #

cd /c/testwxpython
python -m venv virt
source virt/Scripts/activate
pip install wxPython
pip install -r requirements.txt
pip install pyinstaller

pyinstaller --name myapp --onefile --windowed --icon=icon.ico --add-data "YouthTouchDemoRegular-4VwY.ttf;." sample_one.py

解决思路与操作步骤 #

1. 清理冗余依赖，构建干净环境 #

• 编辑requirements.txt，删除所有PyQt5相关条目，只保留WxPython及程序实际需要的依赖包
• 删除现有虚拟环境，重新创建并初始化：

  rm -rf virt
  python -m venv virt
  source virt/Scripts/activate
  pip install wxPython
  pip install -r requirements.txt
  pip install pyinstaller
  

• 重新执行打包命令，避免无关库干扰WxPython的样式渲染

2. 强制控件使用自定义样式，脱离系统主题 #

在WxPython代码中手动指定控件的颜色参数，绑定悬停事件切换状态，不依赖系统默认主题：

import wx

class CustomFrame(wx.Frame):
    def __init__(self):
        super().__init__(None, title="Custom Style Demo")
        panel = wx.Panel(self)
        
        # 初始化按钮并设置默认颜色
        self.demo_btn = wx.Button(panel, label="测试按钮", pos=(60, 60))
        self.default_bg = "#2E8B57"
        self.hover_bg = "#3CB371"
        self.text_color = "#FFFFFF"
        
        self.demo_btn.SetBackgroundColour(self.default_bg)
        self.demo_btn.SetForegroundColour(self.text_color)
        
        # 绑定悬停/离开事件
        self.demo_btn.Bind(wx.EVT_ENTER_WINDOW, self.on_btn_hover)
        self.demo_btn.Bind(wx.EVT_LEAVE_WINDOW, self.on_btn_leave)
        
        # 静态线条设置固定颜色
        self.static_line = wx.StaticLine(panel, pos=(60, 120), size=(200, 2))
        self.static_line.SetForegroundColour("#2E8B57")
        
        self.Show()
    
    def on_btn_hover(self, event):
        self.demo_btn.SetBackgroundColour(self.hover_bg)
        self.demo_btn.Refresh()  # 强制刷新控件
    
    def on_btn_leave(self, event):
        self.demo_btn.SetBackgroundColour(self.default_bg)
        self.demo_btn.Refresh()

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

3. 修改PyInstaller配置，排除Qt相关模块 #

编辑myapp.spec文件，在Analysis部分的excludes参数中添加所有PyQt5相关模块，防止误打包：

a = Analysis(
    ['sample_one.py'],
    pathex=[],
    binaries=[],
    datas=[('YouthTouchDemoRegular-4VwY.ttf', '.')],
    hiddenimports=[],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=['PyQt5', 'PyQt5.QtCore', 'PyQt5.QtGui', 'PyQt5.QtWidgets', 'PyQt5.QtNetwork'],
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=None,
    noarchive=False,
)

然后使用spec文件重新打包：

pyinstaller myapp.spec

4. 验证字体资源加载 #

确保打包的字体文件在目标设备正常加载，可在代码中添加加载验证逻辑：

import os
import wx

# （在窗口初始化代码中添加）
font_path = "YouthTouchDemoRegular-4VwY.ttf"
if os.path.exists(font_path):
    custom_font = wx.Font(wx.FontInfo(10).FaceName("YouthTouchDemoRegular"))
    self.demo_btn.SetFont(custom_font)
else:
    # 加载失败时使用系统默认字体，但保留颜色设置
    pass

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