探究tqdm进度条的线程机制及嵌套循环打印交互问题

问题1：tqdm是否使用单独线程或子进程更新进度条？ #

tqdm默认不依赖单独线程或子进程进行进度条更新。它的核心机制是在主线程的循环迭代过程中，通过终端控制字符（如回车符\r）覆盖当前行内容，实现进度条的动态刷新。只有当你使用tqdm.contrib.concurrent模块下的并行工具（如process_map、thread_map）时，才会涉及线程或进程的使用，但基础的tqdm/trange都是在主线程内完成进度更新的。

问题2：嵌套循环中存在print语句时，tqdm进度条的处理问题 #

问题原因 #

你的代码里进度条直到程序结束才显示，核心原因是print()的输出特性和Python的输出缓冲机制：

1. print()默认会输出换行符\n，每次打印都会生成新行，直接把tqdm的进度条行挤到输出流的上方，导致动态更新的进度条被覆盖，无法实时显示。
2. Python的标准输出是行缓冲模式，tqdm的进度条更新内容会被暂时缓存，直到程序执行结束、缓冲区刷新时才一次性输出。

解决方法 #

可以通过以下几种方式解决这个问题：

方式1：使用tqdm的write()方法替代print

tqdm提供了专门的write()方法，会自动处理进度条的位置，避免打印内容干扰进度条的显示：

from tqdm import trange

def main():
    X = 100
    # 用tqdm实例化，方便调用write方法
    with trange(X) as pbar:
        for i in pbar:
            pbar.write(str(i))
            for j in range(X):
                pbar.write(str(j))
                k = j * i
    print("Done🛠️")
    return 0

if __name__ == '__main__':
    main()

方式2：给print添加flush=True并调整输出行为

强制刷新输出缓冲区，确保进度条和打印内容能实时显示：

from tqdm import trange

def main():
    X = 100
    for i in trange(X):
        # 强制刷新缓冲区，让内容实时输出
        print(i, flush=True)
        for j in range(X):
            print(j, flush=True)
            k = j * i
    print("Done🛠️")
    return 0

if __name__ == '__main__':
    main()

方式3：将print输出重定向到标准错误流

把打印内容输出到sys.stderr，和tqdm的标准输出流分开，避免互相干扰：

import sys
from tqdm import trange

def main():
    X = 100
    for i in trange(X):
        print(i, file=sys.stderr)
        for j in range(X):
            print(j, file=sys.stderr)
            k = j * i
    print("Done🛠️")
    return 0

if __name__ == '__main__':
    main()

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