CustomTkinter控件加载时背景变白问题求助

问题描述 #

使用customtkinter时，设置set_appearance_mode("System")后主题加载正常，但控件背景和边角显示为白色；鼠标悬停能修复按钮文本背景的白色问题，但边角的白色无法解决。目前临时解决方法是先切换到Dark模式再切回System模式：

customtkinter.set_appearance_mode("System")
customtkinter.set_default_color_theme("blue")
customtkinter.set_appearance_mode("Dark")
customtkinter.set_appearance_mode("System")

问题根源 #

这个问题本质是customtkinter在System外观模式初始化阶段，没有完全同步系统主题的颜色配置（尤其是控件背景色、边角样式这类依赖系统主题的属性）。直接设置System模式时，部分控件的样式变量还未完成初始化就被渲染，导致出现白色异常；而切换到Dark再切回System的操作，会强制触发一次完整的主题样式重绘，补全了之前缺失的颜色配置，从而临时解决问题。

彻底修复方案 #

1. 升级customtkinter到最新版本

旧版本的customtkinter存在System模式下的初始化bug，官方后续版本已经修复了这类主题同步问题。执行升级命令：

pip install --upgrade customtkinter

2. 强制触发主题样式刷新

在设置完外观模式和主题后，手动调用窗口的update_idletasks()方法，强制完成所有控件的样式初始化：

import customtkinter as ctk

# 初始化设置
ctk.set_appearance_mode("System")
ctk.set_default_color_theme("blue")

# 创建主窗口
root = ctk.CTk()
# 强制刷新样式
root.update_idletasks()

# 后续控件创建逻辑
button = ctk.CTkButton(root, text="Test Button")
button.pack(padx=20, pady=20)

root.mainloop()

3. 延迟初始化控件

如果刷新方法无效，可以尝试延迟创建控件，给系统主题足够的时间完成颜色同步：

import customtkinter as ctk

ctk.set_appearance_mode("System")
ctk.set_default_color_theme("blue")

root = ctk.CTk()

# 延迟0.1秒后创建控件
root.after(100, lambda: ctk.CTkButton(root, text="Test Button").pack(padx=20, pady=20))

root.mainloop()

4. 手动绑定控件样式变量

如果以上方法都无效，可以直接将控件的背景色绑定到系统主题对应的颜色变量，确保样式正确：

import customtkinter as ctk

ctk.set_appearance_mode("System")
ctk.set_default_color_theme("blue")

root = ctk.CTk()
# 获取当前主题的按钮背景色与边角半径配置
button_theme = ctk.ThemeManager.theme["CTkButton"]
# 创建控件时指定对应样式
button = ctk.CTkButton(root, text="Test Button", fg_color=button_theme["fg_color"], corner_radius=button_theme["corner_radius"])
button.pack(padx=20, pady=20)

root.mainloop()

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