线程控制CustomTkinter组件出现变形：原因及解决方法

在子线程中对CustomTkinter的CTkTabview组件执行激活与禁用操作后，组件出现变形（产生图像伪影），期望组件保持平滑无变形状态，求该问题的成因及解决办法。

问题截图：

• 图1：CTkTabview标签栏出现错位、边缘渲染异常的伪影
• 图2：Tabview整体布局变形，标签文字与组件边框重叠

相关代码 #

from tkinter import *
import customtkinter
import threading

def function():
    tabview.configure(state='disabled')
    # here is other code.....
    tabview.configure(state='normal')
    root.update

customtkinter.set_appearance_mode("dark")
customtkinter.set_default_color_theme("blue")
root = customtkinter.CTk()
root.geometry("465x235+300+200")
root.resizable(False, False)

tabview = customtkinter.CTkTabview(root, fg_color='#242424')
tabview.pack(fill=BOTH, expand=1)

tab_1 = tabview.add("Tab_____1")
tab_2 = tabview.add("Tab_____2")
tab_3 = tabview.add("Tab_____3")
tab_4 = tabview.add("Tab_____4")

thread_ops_directory_read = threading.Thread(target=function)
thread_ops_directory_read.start()

root.mainloop()

CustomTkinter基于Tkinter开发，而Tkinter的GUI操作必须在主线程（主事件循环所在线程）中执行，它本身不具备线程安全性。子线程直接调用组件的configure方法修改状态，会打乱Tkinter的GUI渲染队列，导致组件渲染逻辑混乱，最终出现变形、伪影等异常。

另外代码中存在一个小错误：root.update缺少括号，应为root.update()，但这不是核心问题，关键还是跨线程操作GUI的违规行为。

方法1：用after方法将GUI操作委托给主线程 #

子线程只处理耗时逻辑，GUI相关操作通过主线程的after方法提交到主事件循环执行，这是最简洁的解决方式：

from tkinter import *
import customtkinter
import threading

def function():
    # 提交禁用操作到主线程
    root.after(0, lambda: tabview.configure(state='disabled'))
    # 这里是其他耗时代码.....
    # 提交启用操作到主线程
    root.after(0, lambda: tabview.configure(state='normal'))

customtkinter.set_appearance_mode("dark")
customtkinter.set_default_color_theme("blue")
root = customtkinter.CTk()
root.geometry("465x235+300+200")
root.resizable(False, False)

tabview = customtkinter.CTkTabview(root, fg_color='#242424')
tabview.pack(fill=BOTH, expand=1)

tab_1 = tabview.add("Tab_____1")
tab_2 = tabview.add("Tab_____2")
tab_3 = tabview.add("Tab_____3")
tab_4 = tabview.add("Tab_____4")

thread_ops_directory_read = threading.Thread(target=function)
thread_ops_directory_read.start()

root.mainloop()

方法2：用队列传递GUI操作指令（适合复杂逻辑） #

如果子线程逻辑复杂，可通过队列存储GUI操作任务，主线程定时检查队列并执行操作：

from tkinter import *
import customtkinter
import threading
import queue

def function(gui_queue):
    gui_queue.put(('disable', tabview))
    # 这里是其他耗时代码.....
    gui_queue.put(('enable', tabview))

def process_queue(gui_queue):
    while not gui_queue.empty():
        action, widget = gui_queue.get()
        if action == 'disable':
            widget.configure(state='disabled')
        elif action == 'enable':
            widget.configure(state='normal')
    # 每隔100ms检查一次队列
    root.after(100, process_queue, gui_queue)

customtkinter.set_appearance_mode("dark")
customtkinter.set_default_color_theme("blue")
root = customtkinter.CTk()
root.geometry("465x235+300+200")
root.resizable(False, False)

tabview = customtkinter.CTkTabview(root, fg_color='#242424')
tabview.pack(fill=BOTH, expand=1)

tab_1 = tabview.add("Tab_____1")
tab_2 = tabview.add("Tab_____2")
tab_3 = tabview.add("Tab_____3")
tab_4 = tabview.add("Tab_____4")

gui_queue = queue.Queue()
thread_ops_directory_read = threading.Thread(target=function, args=(gui_queue,))
thread_ops_directory_read.start()

root.after(100, process_queue, gui_queue)
root.mainloop()

核心原则 #

所有涉及CustomTkinter/Tkinter组件的创建、修改、更新操作，必须严格放在主线程中执行；子线程仅负责处理非GUI的耗时任务（如文件读写、数据计算等）。

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