CustomTkinter窗口图标（Favicon）设置异常问题求助

我正在做一个文件整理的小应用，核心的文件夹整理功能已经正常工作了，但现在在用CustomTkinter做GUI时，卡在了窗口图标（favicon）的设置上，不管怎么试都有问题，实在搞不懂：

• 一开始运行程序，主窗口的图标根本不显示
• 点击「Organize Folder」按钮完成整理后，主窗口的图标才会出现
• 而且弹出的成功提示窗口（CTkToplevel）自始至终都不会显示这个图标

我想要实现跨平台的图标设置，所以不想用bitmap格式。我刚接触CustomTkinter，实在摸不清问题出在哪，下面是我的完整代码：

import customtkinter as ctk
from PIL import Image, ImageTk
import os

def create_app():
    global tk_icon
    # Set appearance and theme
    ctk.set_appearance_mode("System")  # Modes: "System" (default), "Dark", "Light"
    ctk.set_default_color_theme("blue")  # Themes: "blue" (default), "green", "dark-blue"

    def center_window(window, width, height):
        screen_width = window.winfo_screenwidth()
        screen_height = window.winfo_screenheight()
        x = (screen_width // 2) - (width // 2)
        y = (screen_height // 2) - (height // 2)
        window.geometry(f"{width}x{height}+{x}+{y}")

    # Initialize main window
    root = ctk.CTk()
    center_window(root, 400, 300)
    icon_path = os.path.abspath("favicon.png")
    img = Image.open(icon_path)
    tk_icon = ImageTk.PhotoImage(img)
    root.iconphoto(True, tk_icon)
    root.title("FileOrganizer")
    root.resizable(width=False, height=False)

    # Configure grid to center widgets
    root.grid_columnconfigure(0, weight=1)
    root.grid_rowconfigure(0, weight=1)
    root.grid_rowconfigure(1, weight=1)

    def show_popup():
        popup = ctk.CTkToplevel(root)
        center_window(popup, 300, 150)
        popup.title("Success")
        popup.attributes('-topmost', True)
        popup.resizable(width=False, height=False)
        root.iconphoto(False, tk_icon)

        popup_label = ctk.CTkLabel(popup, text="ⓘ Folder organized succesfully", font=("Arial", 14))
        popup_label.pack(pady=20)

        close_button = ctk.CTkButton(popup, text="Close", command=popup.destroy)
        close_button.pack(pady=10)

    # Load and display logo (place 'logo.png' in the same directory)
    try:
        img = Image.open("logo.png")
        logo_image = ctk.CTkImage(light_image=img, dark_image=img, size=(150, 150))
        logo_label = ctk.CTkLabel(master=root, image=logo_image, text="")
        logo_label.grid(row=0, column=0, pady=(20, 10))
    except Exception as e:
        print(f"Error loading logo: {e}")

    # Create a larger centered button
    def on_button_click():
        ogDir = os.getcwd()
        os.chdir(ctk.filedialog.askdirectory())
        for item in os.listdir():
            filename, extension = os.path.splitext(item)
            proposedDir = os.path.join(os.getcwd(), extension.replace(".", "").upper())
            if not os.path.isdir(item):
                if not os.path.exists(proposedDir):
                    os.makedirs(os.path.join(os.getcwd(), extension.replace(".", "").upper()))
                os.rename(os.path.abspath(item), os.path.join(proposedDir, item))
        os.chdir(ogDir)
        show_popup()

    button = ctk.CTkButton(
        master=root,
        text="Organize Folder",
        command=on_button_click,
        font=("Product Sans", 14)
    )
    button.grid(row=1, column=0)

    # Start the GUI event loop
    root.mainloop()

if __name__ == "__main__":
    create_app()

问题分析&解决方案 #

我仔细排查了代码里的问题，主要是图标引用回收、设置对象错误、初始化时机这三个点导致的异常，下面是修复后的完整代码，关键修复处都加了注释：

import customtkinter as ctk
from PIL import Image, ImageTk
import os

def create_app():
    # Set appearance and theme
    ctk.set_appearance_mode("System")  # Modes: "System" (default), "Dark", "Light"
    ctk.set_default_color_theme("blue")  # Themes: "blue" (default), "green", "dark-blue"

    def center_window(window, width, height):
        screen_width = window.winfo_screenwidth()
        screen_height = window.winfo_screenheight()
        x = (screen_width // 2) - (width // 2)
        y = (screen_height // 2) - (height // 2)
        window.geometry(f"{width}x{height}+{x}+{y}")

    # Initialize main window
    root = ctk.CTk()
    center_window(root, 400, 300)
    root.title("FileOrganizer")
    root.resizable(width=False, height=False)

    # --- 1. 修复图标加载：提前处理异常+保留引用防止被垃圾回收 ---
    tk_icon = None
    icon_path = os.path.abspath("favicon.png")
    try:
        img = Image.open(icon_path)
        tk_icon = ImageTk.PhotoImage(img)
        root.iconphoto(True, tk_icon)
        # 给窗口绑定属性保留引用，避免Python回收图标对象
        root.tk_icon = tk_icon
    except Exception as e:
        print(f"加载图标失败：{e}")

    # Configure grid to center widgets
    root.grid_columnconfigure(0, weight=1)
    root.grid_rowconfigure(0, weight=1)
    root.grid_rowconfigure(1, weight=1)

    def show_popup():
        popup = ctk.CTkToplevel(root)
        center_window(popup, 300, 150)
        popup.title("Success")
        popup.attributes('-topmost', True)
        popup.resizable(width=False, height=False)
        
        # --- 2. 修复弹窗图标：给popup对象设置图标，而非root ---
        if tk_icon:
            popup.iconphoto(True, tk_icon)
            popup.tk_icon = tk_icon  # 同样保留弹窗的图标引用

        popup_label = ctk.CTkLabel(popup, text="ⓘ Folder organized succesfully", font=("Arial", 14))
        popup_label.pack(pady=20)

        close_button = ctk.CTkButton(popup, text="Close", command=popup.destroy)
        close_button.pack(pady=10)

    # Load and display logo (place 'logo.png' in the same directory)
    try:
        img = Image.open("logo.png")
        logo_image = ctk.CTkImage(light_image=img, dark_image=img, size=(150, 150))
        logo_label = ctk.CTkLabel(master=root, image=logo_image, text="")
        logo_label.grid(row=0, column=0, pady=(20, 10))
        logo_label.logo_image = logo_image  # 保留logo引用防止消失
    except Exception as e:
        print(f"Error loading logo: {e}")

    # Create a larger centered button
    def on_button_click():
        ogDir = os.getcwd()
        target_dir = ctk.filedialog.askdirectory()
        if not target_dir:  # 新增：处理用户取消选择文件夹的情况
            return
        os.chdir(target_dir)
        for item in os.listdir():
            if os.path.isdir(item):
                continue  # 跳过文件夹，只处理文件
            filename, extension = os.path.splitext(item)
            if not extension:  # 新增：跳过无后缀的文件
                continue
            proposedDir = os.path.join(os.getcwd(), extension.replace(".", "").upper())
            if not os.path.exists(proposedDir):
                os.makedirs(proposedDir)
            os.rename(os.path.abspath(item), os.path.join(proposedDir, item))
        os.chdir(ogDir)
        show_popup()

    button = ctk.CTkButton(
        master=root,
        text="Organize Folder",
        command=on_button_click,
        font=("Product Sans", 14)
    )
    button.grid(row=1, column=0)

    # Start the GUI event loop
    root.mainloop()

if __name__ == "__main__":
    create_app()

关键修复说明 #

1. 图标引用保留：通过给窗口对象（root.tk_icon、popup.tk_icon）绑定图标对象，避免Python的垃圾回收机制把图标回收，导致图标消失
2. 弹窗图标设置对象修正：原来的代码错误地给root重复设置图标，现在改为给弹窗popup设置
3. 初始化顺序调整：先设置窗口的基础属性（标题、大小），再加载图标，确保窗口初始化完成后再绑定图标
4. 新增容错处理：添加了文件夹选择取消、无后缀文件的处理，让代码更健壮

修改后启动程序，主窗口会立刻显示图标，弹窗也会正常加载图标，不会再出现之前的异常情况。

内容来源于stack exchange