PySide6 setWindowIcon路径在Windows PyInstaller打包后失效问题

核心问题 #

单文件打包时，PyInstaller会把所有资源解压到系统临时目录，你之前用__file__获取的路径在IDE里有效，但打包后指向的是临时目录里的脚本，而如果图标文件没被正确打包进EXE，运行时自然找不到。另外，pyinstaller命令里的--icon是设置EXE文件本身的图标，和窗口标题栏的图标是两回事，别搞混。

解决步骤 #

1. 修改代码中的图标路径逻辑 #

在代码里加入PyInstaller单文件模式的路径判断，用sys._MEIPASS获取临时目录路径：

import sys
from pathlib import Path
from PySide6.QtWidgets import QApplication, QMainWindow
from PySide6.QtGui import QIcon

def get_resource_path(relative_path):
    # 判断是否是单文件打包模式
    if hasattr(sys, '_MEIPASS'):
        return Path(sys._MEIPASS) / relative_path
    return Path(__file__).parent / relative_path

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = QMainWindow()
    
    # 获取图标路径
    icon_path = get_resource_path("logo.ico")
    app.setWindowIcon(QIcon(str(icon_path)))
    
    window.show()
    sys.exit(app.exec())

2. 调整PyInstaller打包命令 #

用--add-data参数把图标文件强制打包进EXE，Windows系统下命令如下：

pyinstaller --onefile --icon=logo.ico --add-data "logo.ico;." -w .\app.py

如果是macOS/Linux，把分号改成冒号：

pyinstaller --onefile --icon=logo.ico --add-data "logo.ico:." -w ./app.py

• --add-data "logo.ico;."：表示把当前目录的logo.ico打包进去，运行时解压到临时目录的根目录（和脚本同级）
• --icon=logo.ico：这个是设置EXE文件本身的图标，和窗口图标无关，可根据需要保留

3. 检查图标文件的有效性 #

• 确保logo.ico是标准的ICO格式，建议包含256x256尺寸的图标（Windows对图标尺寸有要求，太小可能不显示）
• 文件名要和代码、命令里的完全一致（Windows不区分大小写，但打包时尽量统一）

验证 #

打包完成后，运行生成的EXE，窗口标题栏应该能正常显示图标，同时EXE文件本身的图标也会是你设置的logo.ico（如果命令里加了--icon）。

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