PyInstaller打包后程序最小化消失至后台而非系统托盘问题求助

AI 小北

2026-6-21

PyInstaller打包后pystray托盘不显示的解决方案

针对控制台运行正常、打包exe后点击最小化托盘不显示仅后台运行的问题，可按以下步骤排查修复：

1. 修正图标文件路径

打包后程序的工作目录与开发环境不同，直接使用相对路径会导致图标文件找不到。需通过sys._MEIPASS获取PyInstaller打包后的临时资源目录：

import sys
import os
from pystray import MenuItem as item  # 确保导入MenuItem

def hide_window():
    root.withdraw()
    # 根据运行环境获取正确的图标路径
    if hasattr(sys, '_MEIPASS'):
        icon_path = os.path.join(sys._MEIPASS, 'ImotSearch_MIcon.png')
    else:
        icon_path = 'ImotSearch_MIcon.png'
    image = Image.open(icon_path)
    menu = (item('Exit', quit_window), item('Open', show_window))
    icon = pystray.Icon("web_search", image, "web search", menu)
    icon.run()

2. 调整PyInstaller打包配置

移除UPX压缩：UPX可能破坏pystray依赖的二进制组件，将exe配置中的upx=True改为upx=False。
补充平台相关隐式依赖：Windows平台下pystray依赖pystray._win32，需添加到hiddenimports：

hiddenimports=['requests', 'pystray', 'pystray._win32'],

3. 优化托盘运行的线程逻辑

icon.run()会阻塞主线程，在Tkinter程序中需将托盘运行放到子线程，避免UI卡顿或功能异常：

import threading

def run_tray_icon(icon_path):
    image = Image.open(icon_path)
    menu = (item('Exit', quit_window), item('Open', show_window))
    icon = pystray.Icon("web_search", image, "web search", menu)
    icon.run()

def hide_window():
    root.withdraw()
    if hasattr(sys, '_MEIPASS'):
        icon_path = os.path.join(sys._MEIPASS, 'ImotSearch_MIcon.png')
    else:
        icon_path = 'ImotSearch_MIcon.png'
    # 启动守护线程运行托盘
    tray_thread = threading.Thread(target=run_tray_icon, args=(icon_path,), daemon=True)
    tray_thread.start()