PySide6中QSystemTrayIcon调用hide()后show()失效问题求助

问题现象 #

在Windows 11环境下使用PySide6开发时，动态切换QSystemTrayIcon显示状态会出现异常：

• 启动时图标正常显示
• 调用.hide()或.setVisible(False)后图标成功隐藏
• 再次调用.show()或.setVisible(True)时，图标无法重新显示
• .isVisible()返回True，但系统托盘实际无图标

最小复现代码如下：

import os
import sys
from PySide6.QtWidgets import *
from PySide6.QtCore import *
from PySide6.QtGui import *
import resources_rc

app = QApplication(sys.argv)

def _image(name: str):
    return os.path.join(':', 'saved_files', 'images', f'{name}.png')

tray = QSystemTrayIcon(QIcon(_image('folder')))
tray.show()
print('> Running\n')

def toggle_tray():
    tray.setVisible(not tray.isVisible())
    print(f'[State Toggled] Tray Visible = {tray.isVisible()}')

timer = QTimer()
timer.timeout.connect(toggle_tray)
timer.start(3000)
    
app.exec()

原因分析 #

该问题并非PySide6的直接Bug，而是Windows系统托盘机制与Qt封装逻辑的兼容性冲突：

1. Windows Shell Tray对图标的管理方式特殊，调用隐藏接口时，系统可能会释放托盘图标的资源引用
2. Qt的QSystemTrayIcon在Windows平台下，隐藏后再显示时，未正确向系统重新注册图标资源，导致系统无法渲染
3. .isVisible()仅反映Qt内部的状态标记，未同步系统托盘的实际显示状态

解决方案 #

方案1：优化临时修复（缓存图标对象） #

提前缓存图标实例，避免重复加载资源，同时在显示时重新设置图标：

import os
import sys
from PySide6.QtWidgets import *
from PySide6.QtCore import *
from PySide6.QtGui import *
import resources_rc

app = QApplication(sys.argv)

def _image(name: str):
    return os.path.join(':', 'saved_files', 'images', f'{name}.png')

# 提前缓存图标对象，减少重复IO开销
tray_icon = QIcon(_image('folder'))
tray = QSystemTrayIcon(tray_icon)
tray.show()
print('> Running\n')

def toggle_tray():
    target_visible = not tray.isVisible()
    tray.setVisible(target_visible)
    if target_visible:
        # 显示时重新设置图标（复用缓存对象）
        tray.setIcon(tray_icon)
    print(f'[State Toggled] Tray Visible = {tray.isVisible()}')

timer = QTimer()
timer.timeout.connect(toggle_tray)
timer.start(3000)
    
app.exec()

方案2：直接调用show/hide接口 #

部分场景下，直接调用.show()和.hide()比设置setVisible()更稳定：

def toggle_tray():
    if tray.isVisible():
        tray.hide()
    else:
        tray.show()
        tray.setIcon(tray_icon)  # 仍需配合重新设置图标
    print(f'[State Toggled] Tray Visible = {tray.isVisible()}')

疑问解答 #

1. 为什么原代码无法正常工作？
   Windows系统托盘在隐藏图标时会释放相关资源，Qt的QSystemTrayIcon未处理资源回收后的重新注册逻辑，导致显示命令无法被系统正确响应。

2. 这是PySide6的Bug吗？
   更准确地说是Qt框架在Windows平台的兼容性问题，PySide6只是封装了Qt的底层实现。该问题在Qt的bug追踪系统中已有相关记录，与Windows Shell Tray的交互逻辑有关。

3. 临时方案是否有副作用？
   重新设置图标不会影响托盘的菜单、提示信息等其他功能，缓存图标对象后也不会带来性能问题，是当前可行的稳定解决方案。

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