PySide6应用图标在文件资源管理器中不显示的问题排查

代码里通过setWindowIcon设置的图标仅负责运行时窗口标题栏、任务栏的显示，文件资源管理器中显示的是可执行文件本身嵌入的图标资源，需要在打包阶段完成配置，以下是针对pyside6-deploy的有效解决方法：

方法一：修改.spec文件重新打包 #

1. 先执行一次pyside6-deploy生成对应的.spec文件（比如你的主脚本是main.py，运行命令：pyside6-deploy main.py）
2. 打开生成的pysidedeply.spec文件，找到exe配置块，添加icon参数指定图标路径：

   exe = EXE(
       pyz,
       a.scripts,
       [],
       exclude_binaries=True,
       name='your_app_name',
       debug=False,
       bootloader_ignore_signals=False,
       strip=False,
       upx=True,
       console=False,  # 若为GUI应用设为False
       icon='icons/icon.ico',  # 填入你的图标相对/绝对路径
       disable_windowed_traceback=False,
       target_arch=None,
       codesign_identity=None,
       entitlements_file=None,
   )
   

3. 基于修改后的spec文件重新打包：pyside6-deploy --spec pysidedeply.spec

方法二：使用pyside6-deploy的平台专属参数 #

pyside6-deploy针对Windows平台的图标参数是--windows-icon，而非通用的--icon，直接在打包命令中指定：

pyside6-deploy your_main_script.py --windows-icon icons/icon.ico

额外注意事项 #

• 确保图标是Windows兼容的ICO格式，建议包含256x256尺寸以适配高DPI屏幕
• 图标路径需与打包命令的执行目录相对应，或使用绝对路径
• 打包完成后若图标仍不显示，可重启文件资源管理器（或注销再登录），这是Windows图标缓存导致的延迟

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