问题产生的原因
tqdm的进度条默认是通过在终端同一行不断覆盖内容来实现动态刷新效果的，而Python内置的print函数默认会在输出内容后添加换行符，并且会直接写入标准输出流，这会打断tqdm的刷新逻辑，导致之前的进度条没有被正确覆盖，新的进度条又生成，最终出现重复、混乱的输出效果。
解决方案一：使用 tqdm.write 替代 print
tqdm内置了tqdm.write方法，这个方法会先暂停进度条的刷新，输出指定内容后再恢复进度条的刷新，从根源上避免输出冲突，是最推荐的解决方式。
from tqdm import tqdm
import time
# 模拟循环任务
for i in tqdm(range(10), desc="处理任务"):
time.sleep(0.5)
# 使用tqdm.write输出内容，不会打乱进度条
if i == 3:
tqdm.write(f"当前处理到第{i}个任务，出现特殊情况")解决方案二：调整 print 的参数
如果暂时不方便替换print为tqdm.write，可以调整print的参数，让它在输出前先刷新tqdm的进度条，输出后再恢复进度条状态。
from tqdm import tqdm
import time
# 创建进度条对象
pbar = tqdm(range(10), desc="处理任务")
for i in pbar:
time.sleep(0.5)
if i == 3:
# 先刷新进度条，再输出print内容
pbar.refresh()
print(f"当前处理到第{i}个任务，出现特殊情况")解决方案三：关闭进度条动态刷新
如果不需要动态刷新的进度条效果，可以在初始化tqdm时设置dynamic_ncols=False或者直接设置leave=True并且关闭刷新，不过这种方式会让进度条每次都输出新的一行，适合对动态效果要求不高的场景。
from tqdm import tqdm
import time
# 关闭动态刷新，每次进度更新都输出新行
for i in tqdm(range(10), desc="处理任务", dynamic_ncols=False):
time.sleep(0.5)
if i == 3:
print(f"当前处理到第{i}个任务，出现特殊情况")方案对比
| 方案 | 优点 | 缺点 |
|---|---|---|
| 使用tqdm.write | 完全避免冲突，输出逻辑最清晰 | 需要替换原有的print调用 |
| 调整print参数 | 改动小，兼容原有代码 | 需要持有进度条对象引用 |
| 关闭动态刷新 | 实现简单，无额外逻辑 | 输出内容较多，终端不够整洁 |
注意事项
- 如果是在多线程或者多进程环境中使用tqdm，还需要额外设置
position和leave参数，避免不同任务的进度条互相干扰。 - 不要在tqdm的更新回调函数中直接使用
print，即使使用了上述方案，也可能因为回调执行时机问题导致输出异常。 - 如果输出内容包含特殊格式，建议先测试输出效果，避免格式字符影响进度条的显示逻辑。
通过上述几种方案，基本可以解决所有print导致tqdm进度条重复的问题，开发者可以根据自己项目的实际情况选择最合适的方案。