在Python中使用tqdm库实现迭代进度条时，如果在循环过程中调用print函数输出日志或调试信息，经常会出现进度条被重复打印的情况，既影响输出可读性，也不利于观察程序运行进度。下面来分析问题原因并提供对应解决方案。
问题产生的原因
tqdm的进度条是通过不断刷新同一行标准输出实现的，默认情况下进度条会输出到标准错误流（stderr）。而print函数默认输出到标准输出流（stdout），并且会在输出内容后自动添加换行符。当print输出内容时，会打乱tqdm的行刷新逻辑，导致之前的进度条内容没有被覆盖，从而出现重复打印的现象。
解决方案
1. 使用tqdm自带的write方法替代print
tqdm提供了内置的write方法，该方法会先暂停进度条的刷新，输出指定内容后再恢复进度条，避免输出冲突。示例代码如下：
from tqdm import tqdm
import time
# 创建进度条
pbar = tqdm(range(10))
for i in pbar:
time.sleep(0.5)
# 使用tqdm的write方法输出内容，不会破坏进度条
pbar.write(f"当前处理到第{i}个任务")2. 将print内容输出到标准错误流
让print函数的输出和tqdm的进度条输出到同一个流（stderr），可以避免流切换导致的行刷新问题。可以通过指定file参数实现：
from tqdm import tqdm
import time
import sys
# 创建进度条
for i in tqdm(range(10)):
time.sleep(0.5)
# 将print输出到标准错误流，和tqdm输出流一致
print(f"当前处理到第{i}个任务", file=sys.stderr)3. 设置tqdm的输出位置偏移
可以通过position参数设置进度条的输出行位置，让进度条和print输出内容处于不同行，避免相互干扰：
from tqdm import tqdm
import time
# 设置position=1，进度条输出到第2行，print输出到第1行
for i in tqdm(range(10), position=1, leave=False):
time.sleep(0.5)
print(f"当前处理到第{i}个任务")4. 关闭进度条的动态刷新，使用静态模式
如果不需要动态刷新的进度条，可以设置dynamic_ncols=False或者直接使用静态输出模式，减少刷新冲突：
from tqdm import tqdm
import time
# 关闭动态列宽调整，减少刷新冲突
for i in tqdm(range(10), dynamic_ncols=False):
time.sleep(0.5)
print(f"当前处理到第{i}个任务")方案选择建议
如果需要在进度条运行过程中输出日志，优先选择tqdm自带的write方法，这是最稳妥的解决方案。如果输出内容较少且不需要频繁输出，也可以选择将print重定向到stderr的方式。如果程序运行环境对输出行数没有限制，设置position偏移也是简单有效的选择。
| 方案 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|
| tqdm.write方法 | 频繁输出日志或调试信息 | 完全避免冲突，输出整齐 | 需要替换原有print调用 |
| print重定向到stderr | 少量输出，不想修改过多代码 | 改动成本低 | 多个print仍可能打乱进度条 |
| 设置position偏移 | 输出内容与进度条可以分行展示 | 实现简单，无需改动输出逻辑 | 会占用更多输出行 |