如何在CustomTkinter中添加进度条？能否用tqdm替代原生进度条？

一、解决进度条与函数同步的问题 #

问题核心 #

你的代码存在两个关键问题：

1. 语法缩进错误：__init__内的进度条初始化代码、test函数内的循环均未正确缩进，导致代码无法正常运行；
2. UI阻塞问题：test函数在主线程执行时会阻塞UI刷新，进度条只能等函数完全执行完才会更新；同时原test函数的循环内直接return，导致函数仅执行一次就终止，无法体现进度变化。

修复方案：线程分离耗时任务 #

将计算任务放到子线程中运行，通过主线程安全的方式更新进度条：

import customtkinter as CTK
import threading

class App(CTK.CTk):
    def __init__(self):
        super().__init__()
        self.title("进度条同步示例")
        
        # 先初始化checkbox（原代码中进度条的master为self.checkbox，需提前定义）
        self.checkbox = CTK.CTkCheckBox(self, text="示例复选框")
        self.checkbox.grid(row=0, column=0, padx=20, pady=20)
        
        # 初始化进度条，修正缩进与初始值
        self.bar = CTK.CTkProgressBar(master=self.checkbox, orientation='horizontal', mode='determinate')
        self.bar.grid(row=10, column=0, pady=10, padx=20, sticky="n")
        self.bar.set(0)  # 初始进度设为0
        
        # 创建触发按钮
        self.run_btn = CTK.CTkButton(self, text="运行任务", command=self.start_task)
        self.run_btn.grid(row=1, column=0, padx=20, pady=10)

    def update_progress(self, value):
        # 主线程内更新进度条，保证UI线程安全
        self.bar.set(value)
        self.update_idletasks()  # 强制刷新UI

    def test(self):
        total = 500
        for x in range(total):
            # 模拟耗时计算
            result = x**2
            # 计算当前进度（转换为0-1之间的数值）
            current_progress = (x + 1) / total
            # 通过after方法将进度更新操作抛回主线程
            self.after(0, self.update_progress, current_progress)
        # 任务完成后重置进度条
        self.after(0, lambda: self.update_progress(0))

    def start_task(self):
        # 子线程运行test函数，避免阻塞UI主线程
        threading.Thread(target=self.test, daemon=True).start()

if __name__ == "__main__":
    app = App()
    app.mainloop()

关键说明 #

• 用threading.Thread将计算任务分离到子线程，彻底避免UI阻塞；
• 通过self.after(0, ...)将进度条更新操作转回主线程，符合CustomTkinter的UI操作规范；
• 修正了test函数的循环逻辑，确保完成全部计算并逐步更新进度。

二、用tqdm替代原生进度条的可行性 #

tqdm本质是命令行进度工具，无法直接在CustomTkinter界面中显示，但可以捕获tqdm的进度值，同步更新原生进度条，实现类似效果：

import customtkinter as CTK
import threading
from tqdm import tqdm

class App(CTK.CTk):
    def __init__(self):
        super().__init__()
        self.title("tqdm同步进度条")
        
        self.checkbox = CTK.CTkCheckBox(self, text="示例复选框")
        self.checkbox.grid(row=0, column=0, padx=20, pady=20)
        
        self.bar = CTK.CTkProgressBar(master=self.checkbox, orientation='horizontal', mode='determinate')
        self.bar.grid(row=10, column=0, pady=10, padx=20, sticky="n")
        self.bar.set(0)
        
        self.run_btn = CTK.CTkButton(self, text="运行tqdm任务", command=self.start_tqdm_task)
        self.run_btn.grid(row=1, column=0, padx=20, pady=10)

    def update_progress(self, value):
        self.bar.set(value)
        self.update_idletasks()

    def tqdm_task(self):
        total = 500
        # 启动命令行tqdm进度条，同时捕获进度值同步到UI
        for x in tqdm(range(total), desc="计算进度"):
            result = x**2
            current_progress = (x + 1) / total
            self.after(0, self.update_progress, current_progress)
        self.after(0, lambda: self.update_progress(0))

    def start_tqdm_task(self):
        threading.Thread(target=self.tqdm_task, daemon=True).start()

if __name__ == "__main__":
    app = App()
    app.mainloop()

说明 #

• 此方案保留了tqdm的命令行进度提示，同时将进度同步到CustomTkinter的UI进度条；
• tqdm没有官方的CustomTkinter组件，若需要纯GUI的tqdm风格进度条，可通过自定义CTkProgressBar的样式来模仿。

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