CustomTkinter自定义颜色主题切换不生效问题排查与解决

在项目中尝试从user_themes文件夹下预加载的Anthracite.json、Cobalt.json、Blue.json主题文件中选择颜色模板，通过下拉菜单触发主题加载。编写的代码如下：

from customtkinter import CTkLabel, CTkButton, CTkOptionMenu, set_default_color_theme, CTk
root = CTk()
root.geometry("400x400")


def click():
    CTkLabel(root, text="Here is some text").pack(pady=20)


def new_color_theme(nct: str):
    print(nct)
    set_default_color_theme(f"user_themes/{nct}.json")


btn = CTkButton(root, text="Click me", command=click).pack(pady=20)
lst = ["Anthracite", "Cobalt", "Blue"]
menu = CTkOptionMenu(root, values=lst, command=new_color_theme).pack(pady=20)
root.mainloop()

但切换主题时仅能打印主题名称，主题并未在窗口中生效。请问该问题的原因是什么，如何修正？

• set_default_color_theme()仅对调用之后新建的组件生效，对已经创建好的组件（比如代码中的按钮、下拉菜单）不会触发样式更新。
• 即使设置了新的默认主题，customtkinter不会自动刷新现有窗口的样式逻辑，必须手动触发组件的样式更新。

要实现主题切换并让所有组件（包括已创建和后续创建的）生效，需要完成两个核心步骤：

1. 保留set_default_color_theme()调用，确保后续新建的组件自动应用新主题；
2. 手动刷新现有组件的样式，让已创建的组件同步更新主题。

完整修正代码 #

from customtkinter import CTkLabel, CTkButton, CTkOptionMenu, set_default_color_theme, CTk
root = CTk()
root.geometry("400x400")

def click():
    CTkLabel(root, text="Here is some text").pack(pady=20)

# 递归遍历所有组件并刷新样式
def refresh_all_widgets(widget):
    widget.configure()
    for child in widget.winfo_children():
        refresh_all_widgets(child)

def new_color_theme(nct: str):
    print(nct)
    # 设置新的默认主题
    set_default_color_theme(f"user_themes/{nct}.json")
    # 刷新根窗口的主题上下文
    root._apply_appearance_mode_and_theme()
    # 递归刷新所有现有组件的样式
    refresh_all_widgets(root)

btn = CTkButton(root, text="Click me", command=click)
btn.pack(pady=20)

lst = ["Anthracite", "Cobalt", "Blue"]
menu = CTkOptionMenu(root, values=lst, command=new_color_theme)
menu.pack(pady=20)

root.mainloop()

关键说明 #

• root._apply_appearance_mode_and_theme()是customtkinter的内部方法，用于重新将主题规则应用到窗口全局；
• refresh_all_widgets()函数通过递归遍历窗口内的所有子组件，调用configure()触发样式更新，无需手动维护组件列表，适配复杂层级的界面。

内容的提问来源于stack exchange，提问作者Soumil Ghosh Dastidar