PyInstaller打包的macOS应用系统托盘图标不显示问题求助

针对你遇到的打包后托盘图标不显示（菜单正常）的问题，核心原因是资源路径失效和macOS托盘图标格式兼容性问题，以下是具体解决步骤：

1. 修正图标路径的加载逻辑 #

PyInstaller打包后，脚本运行路径会切换到临时目录（sys._MEIPASS），直接用相对路径会找不到资源。修改图标加载代码，同时兼容开发环境和打包后的运行环境：

import sys
import os
from PySide6.QtWidgets import QApplication, QSystemTrayIcon, QMenu, QAction, QMessageBox
from PySide6.QtGui import QIcon

# 获取资源文件的绝对路径
def get_resource_path(relative_path):
    if hasattr(sys, '_MEIPASS'):
        return os.path.join(sys._MEIPASS, relative_path)
    return os.path.join(os.path.dirname(__file__), relative_path)

app = QApplication()
main_window = MainWindow()
if not QSystemTrayIcon.isSystemTrayAvailable():
    QMessageBox.critical(None, 'System Tray', 'System tray was not detected!')
    sys.exit(1)

app.setQuitOnLastWindowClosed(False)

# 使用修正后的路径加载图标（建议换成icns格式）
icon = QIcon(get_resource_path('ressources/icon.icns'))

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

# 菜单部分代码保持不变
menu = QMenu()
action_hello = QAction('Hello World')
action_hello.triggered.connect(main_window.say_hello)
menu.addAction(action_hello)

action_exit = QAction('Exit')
action_exit.triggered.connect(app.exit)
menu.addAction(action_exit)

tray.setToolTip('Hello World app')
tray.setContextMenu(menu)
tray.show()

app.exec()

2. 更换图标为macOS兼容的.icns格式 #

macOS系统托盘对图标格式有要求，JPG格式可能无法正常渲染。你需要将图标转换为.icns格式：

• 可以用macOS自带的iconutil命令转换：先准备包含不同尺寸PNG图标的.iconset文件夹，再执行：

  iconutil -c icns your_icon.iconset
  

• 替换代码中的icon.jpg为icon.icns。

3. 确保PyInstaller打包时包含资源文件 #

打包时必须明确告诉PyInstaller要包含资源目录，否则打包后的程序找不到图标文件：

方法1：命令行直接打包 #

使用--add-data参数指定资源的路径映射：

pyinstaller --add-data "ressources/icon.icns:ressources" --windowed your_script.py

--windowed参数会隐藏终端窗口，适合GUI应用。

方法2：使用.spec文件打包 #

1. 先生成.spec文件：

   pyinstaller --name your_app --windowed your_script.py
   

2. 打开生成的your_app.spec，找到datas字段，添加资源路径：

   datas=[('ressources/icon.icns', 'ressources')],
   

3. 用.spec文件重新打包：

   pyinstaller your_app.spec
   

4. 额外注意事项 #

• 确保MainWindow类已正确定义，避免窗口初始化问题间接影响托盘图标显示；
• macOS下托盘图标可能需要等待几秒才会显示，打包后可稍作等待再判断；
• 如果图标仍不显示，可尝试在tray.setIcon(icon)后调用tray.update()强制刷新。

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