qt托盘图标必须使用qapplication而非qcoreapplication，需调用show()并设置图标、提示与上下文菜单，左键点击需连接activated信号，窗口关闭应隐藏而非销毁，且需适配多平台特性。
Qt托盘图标需要QSystemTrayIcon类，但必须搭配QApplication和事件循环
没启用GUI事件循环，QSystemTrayIcon 会立即失效或不响应点击——这是新手最常卡住的地方。Qt的托盘图标不是纯UI组件，它依赖QApplication（而非QCoreApplication）来处理系统级消息（比如Windows的WM_TRAYNOTIFY或macOS的NSStatusItem事件）。
实操建议：
- 主函数必须使用
QApplication app(argc, argv);，不能用QCoreApplication - 确保在
app.exec()之前创建并显示托盘图标，否则图标可能闪现即消失 - Linux下需确认桌面环境支持XDG托盘协议（如KDE、GNOME 42+默认支持；Wayland会话中部分发行版需额外配置）
QSystemTrayIcon构造后必须调用show()，且图标资源路径容易出错
QSystemTrayIcon 默认不显示，即使设置了图标和提示也不行。更隐蔽的问题是：图标路径若为相对路径，在打包或不同工作目录下极易加载失败，表现为托盘无图标或显示为“空白方块”。
实操建议：
- 务必调用
trayIcon.show();，建议紧跟在setToolTip()和setIcon()之后 - 图标优先用
QPixmap加载资源，推荐从qrc资源文件读取：QIcon(":/icons/tray.png")；避免用QIcon("./icons/tray.png") - 图标尺寸建议提供16×16、22×22、32×32多分辨率，Qt会自动适配高DPI屏幕；单尺寸在HiDPI下可能模糊或缩放异常
右键菜单要用QMenu + setContextMenu()，信号连接不能漏掉activated
托盘图标的右键菜单不是自动弹出的，必须显式设置上下文菜单；而左键单击默认无行为，需手动连接 activated 信号——很多人只连了右键，忘了左键点击逻辑。
实操建议：
- 创建
QMenu后，用trayIcon.setContextMenu(menu);绑定，不是menu->exec() - 响应左键单击：连接
QSystemTrayIcon::ActivationReason枚举判断动作：connect(&trayIcon, &QSystemTrayIcon::activated, [&](QSystemTrayIcon::ActivationReason r) { if (r == QSystemTrayIcon::Trigger) showMainWindow(); }); - 菜单项建议用
QAction的setShortcutVisibleInContextMenu(false)避免快捷键干扰视觉
应用最小化到托盘时，主窗口需隐藏但不能销毁，且要拦截closeEvent
直接关闭主窗口会导致整个进程退出，托盘图标随之消失。用户点“关闭”时，应隐藏窗口而非销毁，同时阻止默认关闭行为。
实操建议：
- 重写主窗口的
closeEvent(QCloseEvent *event)，调用hide()并event->ignore() - 不要在
hide()后调用deleteLater()或close() - 如果希望双击托盘图标恢复窗口，需在
activated信号里检查窗口是否隐藏：if (!window->isVisible()) window->showNormal(); window->raise(); window->activateWindow();
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
