PyInstaller打包EXE后QSystemTrayIcon系统托盘组件不显示求助

针对IDE运行正常、打包EXE后系统托盘组件无法显示的问题，可尝试以下解决方案：

1. 修正资源文件路径逻辑 #

PyInstaller打包后，资源文件会被放入临时运行目录，直接用os.path.abspath无法正确定位。修改图标加载代码：

import os
import sys

def get_resource_path(relative_path):
    try:
        # 打包后的临时资源目录
        base_path = sys._MEIPASS
    except Exception:
        # IDE运行时的当前工作目录
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

# 替换原图标加载语句
icon = QIcon(get_resource_path("mouse_tray_enabled.png"))

2. 调整PyInstaller打包配置 #

确保资源正确打包 #

保持spec文件的datas配置不变，执行打包时直接调用spec文件：

pyinstaller SystemTrayApp.spec

添加隐藏依赖导入 #

PyInstaller可能未自动打包PyQt5托盘相关的子模块，在spec文件的hiddenimports中补充：

hiddenimports=['PyQt5.QtWidgets', 'PyQt5.QtGui'],

关闭控制台窗口 #

将spec文件中console=True改为console=False，避免控制台窗口干扰托盘组件初始化：

console=False,

3. 系统层面排查 #

• 检查Windows系统托盘的「隐藏图标」设置，确认程序图标未被自动隐藏
• 重启资源管理器（执行命令taskkill /f /im explorer.exe && start explorer.exe），清除托盘缓存

4. 优化托盘可见性验证逻辑 #

原代码的即时检查可能因初始化延迟导致结果不准确，添加延迟验证：

from PyQt5.QtCore import QTimer

def check_tray_status(tray):
    if tray.isSystemTrayAvailable():
        print("系统托盘功能可用")
        print("系统托盘组件已显示" if tray.isVisible() else "系统托盘组件已创建但未显示")
    else:
        print("系统托盘功能不可用")

# 延迟1秒执行检查，确保托盘初始化完成
QTimer.singleShot(1000, lambda: check_tray_status(tray))

修改后的完整测试代码 #

import os
import sys
from PyQt5.QtGui import QIcon
from PyQt5.QtWidgets import QApplication, QSystemTrayIcon, QMenu, QAction
from PyQt5.QtCore import QTimer

def get_resource_path(relative_path):
    try:
        base_path = sys._MEIPASS
    except Exception:
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

app = QApplication([]) 
app.setQuitOnLastWindowClosed(False) 

icon = QIcon(get_resource_path("mouse_tray_enabled.png"))

tray = QSystemTrayIcon() 
tray.setIcon(icon) 
tray.setVisible(True) 

menu = QMenu() 
option1 = QAction("选项1") 
option2 = QAction("选项2") 
menu.addAction(option1) 
menu.addAction(option2) 

quit_now = QAction("退出") 
quit_now.triggered.connect(app.quit) 
menu.addAction(quit_now) 

tray.setContextMenu(menu) 

def check_tray_status(tray):
    if tray.isSystemTrayAvailable():
        print("系统托盘功能可用")
        print("系统托盘组件已显示" if tray.isVisible() else "系统托盘组件已创建但未显示")
    else:
        print("系统托盘功能不可用")

QTimer.singleShot(1000, lambda: check_tray_status(tray))

app.exec_()

修改后的spec文件 #

a = Analysis(
    ['SystemTrayApp.py'],
    pathex=[],
    binaries=[],
    datas=[('mouse_tray_enabled.png', '.')],
    hiddenimports=['PyQt5.QtWidgets', 'PyQt5.QtGui'],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    noarchive=False,
    optimize=0,
)
pyz = PYZ(a.pure)

exe = EXE(
    pyz,
    a.scripts,
    a.binaries,
    a.datas,
    [],
    name='SystemTrayApp',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    upx_exclude=[],
    runtime_tmpdir=None,
    console=False,
    disable_windowed_traceback=False,
    argv_emulation=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None,
)

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