PyInstaller打包TkinterDnD应用时窗口图标失效问题的解决详解

# 导入必要的库
import os
import sys
import tkinter as tk
from tkinterdnd2 import TkinterDnD # 如果使用了 tkinterdnd2

def resource_path(relative_path):
    """
    获取资源文件的绝对路径，用于处理 PyInstaller 打包后的情况。
    这个函数会判断当前环境是开发环境还是 PyInstaller 打包后的环境，
    并返回正确的资源文件路径。

    Args:
        relative_path (str): 资源文件相对于脚本或打包目录的相对路径。

    Returns:
        str: 资源文件的绝对路径。
    """
    try:
        # PyInstaller 创建临时文件夹，并将路径存储在 _MEIPASS 中
        # 如果程序正在 PyInstaller 创建的临时环境中运行，sys._MEIPASS 会被设置
        base_path = sys._MEIPASS
    except Exception:
        # 如果不在 PyInstaller 环境中（即开发环境），使用当前脚本的目录
        base_path = os.path.abspath(".")
    # 返回完整的资源文件路径
    return os.path.join(base_path, relative_path)

# --- 示例：在您的 Tkinter 应用类中使用 ---
class MyApplication:
    def __init__(self, root):
        self.root = root
        self.root.title("我的 Tkinter 应用")

        # ... 其他 GUI 初始化代码 ...

        # 初始化完成后，设置窗口图标
        self.set_window_icon()

    def set_window_icon(self):
        """
        设置 Tkinter 窗口的图标。
        """
        # 假设您的图标文件名为 'my_app_icon.ico'，并放在与脚本同级目录
        icon_filename = "my_app_icon.ico" # 也可以是子目录路径，如 "assets/my_app_icon.ico"
        icon_path = resource_path(icon_filename)

        try:
            # 检查图标文件是否存在
            if os.path.exists(icon_path):
                # 使用构建的完整路径设置图标
                self.root.iconbitmap(icon_path)
                print(f"窗口图标设置成功: {icon_path}")
            else:
                print(f"警告：图标文件未找到: {icon_path}")
                # 可以选择不设置图标，或者显示一个错误提示
        except tk.TclError as e:
            print(f"设置窗口图标失败 (TclError): {e}")
            # 图标格式错误或不支持时会抛出 TclError
        except Exception as e:
            print(f"设置窗口图标失败 (其他错误): {e}")

# --- 主程序入口 ---
if __name__ == "__main__":
    # 如果使用了 tkinterdnd2，必须使用 TkinterDnD.Tk()
    root = TkinterDnD.Tk()
    # 创建应用实例
    app = MyApplication(root)
    # 启动 GUI 主循环
    root.mainloop()

# Windows 示例
pyinstaller --onefile --windowed --icon=my_app_icon.ico --add-data "my_app_icon.ico;." your_script.py

# Linux/macOS 示例
pyinstaller --onefile --windowed --icon=my_app_icon.ico --add-data "my_app_icon.ico:." your_script.py