PyInstaller打包PyQt5程序后任务栏与Alt+Tab图标不显示问题求助

核心原因 #

单文件打包（--onefile）模式下，PyInstaller会将程序资源临时解压到系统临时目录，Qt调用图标时可能无法正确定位资源路径；另外Windows任务栏的图标关联需要额外的窗口层级处理。

解决方案 #

1. 修正图标路径获取逻辑 #

在代码中加入单文件模式下的资源路径判断，确保程序能找到图标文件：

import sys
import os
from PyQt5.QtWidgets import QApplication, QMainWindow
from PyQt5.QtGui import QIcon

def get_resource_path(relative_path):
    # 适配PyInstaller单文件模式的资源路径
    try:
        base_path = sys._MEIPASS
    except Exception:
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.setWindowTitle("Test Window")
        # 使用处理后的路径设置窗口图标
        icon_path = get_resource_path("pixel-heart.ico")
        self.setWindowIcon(QIcon(icon_path))
        self.show()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    # 同时给QApplication实例设置图标
    icon_path = get_resource_path("pixel-heart.ico")
    app.setWindowIcon(QIcon(icon_path))
    window = MainWindow()
    sys.exit(app.exec_())

2. Windows任务栏图标强制绑定（可选） #

如果上述方法无效，添加Windows API调用强制绑定任务栏图标（需先安装pywin32：pip install pywin32）：

import win32api
import win32con
import win32gui

# 在窗口show()之后添加以下代码
hwnd = win32gui.GetForegroundWindow()
# 分别设置窗口的大、小图标
win32api.SendMessage(hwnd, win32con.WM_SETICON, win32con.ICON_BIG, win32gui.LoadImage(0, icon_path, win32con.IMAGE_ICON, 0, 0, win32con.LR_LOADFROMFILE))
win32api.SendMessage(hwnd, win32con.WM_SETICON, win32con.ICON_SMALL, win32gui.LoadImage(0, icon_path, win32con.IMAGE_ICON, 0, 0, win32con.LR_LOADFROMFILE))

3. 调整PyInstaller打包命令 #

添加--add-data参数确保图标文件被正确打包：

pyinstaller --onefile --noconsole --icon=pixel-heart.ico --add-data "pixel-heart.ico;." main.py

该参数会将图标文件打包进程序，运行时自动解压到临时目录根目录，与代码中的路径逻辑匹配。

验证步骤 #

1. 重新打包程序
2. 运行生成的exe，查看任务栏和Alt+Tab菜单的图标显示状态
3. 若仍有异常，可尝试将图标文件直接放在exe同目录下测试

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