Qt Design Studio项目设置软件图标问题求助（CMake/Qrc）

针对你用Qt Design Studio 4.7.0开发、PySide6转换的项目中，app.setWindowIcon()和窗口setWindowIcon()方法加载图标成功但无法显示在标题栏和任务栏的问题，以下是针对性解决步骤：

1. 验证图标资源加载有效性 #

首先确认图标文件路径正确，可通过打印图标状态排查：

from PySide6.QtGui import QIcon

icon = QIcon(":/icons/your_app_icon.ico")  # 替换为你的QRC资源路径或本地绝对路径
print(f"图标加载状态：{'成功' if not icon.isNull() else '失败'}")

如果输出“失败”，检查：

• QRC文件是否正确包含图标，且pyside6-rcc转换命令执行无误
• 资源路径格式是否正确（QRC资源需以:开头，如:icons/app.ico）
• 图标文件格式是否兼容（推荐使用ICO格式，避免SVG在部分平台显示异常）

2. 确保在窗口显示前设置图标 #

将图标设置代码放在窗口show()方法之前，且同时设置全局应用图标和窗口图标：

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

if __name__ == "__main__":
    app = QApplication(sys.argv)
    
    # 全局应用图标设置
    app_icon = QIcon(":/icons/app.ico")
    app.setWindowIcon(app_icon)
    
    # 窗口图标设置
    window = QMainWindow()
    window.setWindowTitle("测试应用")
    window.setWindowIcon(app_icon)
    
    window.show()
    sys.exit(app.exec())

3. Windows平台任务栏图标特殊处理 #

Windows系统中，Python脚本运行时任务栏默认显示Python解释器图标，需通过设置进程AppUserModelID让系统识别自定义图标：

import sys
import ctypes
from PySide6.QtWidgets import QApplication, QMainWindow
from PySide6.QtGui import QIcon

if __name__ == "__main__":
    # Windows平台专属设置，放在QApplication创建前
    if sys.platform == "win32":
        # 自定义唯一标识字符串，格式建议：公司.产品.版本
        myappid = "your.company.appname.v1.0"
        ctypes.windll.shell32.SetCurrentProcessExplicitAppUserModelID(myappid)
    
    app = QApplication(sys.argv)
    app_icon = QIcon(":/icons/app.ico")
    app.setWindowIcon(app_icon)
    
    window = QMainWindow()
    window.setWindowIcon(app_icon)
    window.show()
    sys.exit(app.exec())

4. 打包时的图标配置 #

如果最终需要打包成可执行文件，以PyInstaller为例，需在打包命令中指定图标：

pyinstaller --onefile --windowed --icon=your_app_icon.ico your_script.py

打包后可执行文件的图标会自动关联到任务栏和窗口标题栏。

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