如何将Python库tqdm的控制台进度条输出保存到文件？

问题原因 #

• tqdm默认会自动检测输出目标是否为交互式终端（TTY），如果检测到输出到非终端的文件，默认会关闭进度条输出，避免生成大量冗余内容。
• 仅全局重定向sys.stdout/sys.stderr没有额外配置的话，无法触发tqdm在非TTY环境下的输出逻辑。

解决方案 #

方案1：直接指定tqdm输出流（推荐） #

无需全局修改标准输出流，在tqdm初始化时直接指定输出文件，同时配置适配文件输出的参数即可：

from tqdm import tqdm
import time

with open("progress.log", "w", encoding="utf-8") as f:
    # 配置参数适配文件输出
    for i in tqdm(
        range(100),
        file=f, # 指定输出流为目标文件
        mininterval=1, # 最少1秒更新一次，避免生成过多内容
        ncols=80, # 固定进度条宽度，避免格式错乱
        ascii=True # 可选，输出ASCII格式兼容所有文本编辑器
    ):
        time.sleep(0.1) # 替换为你的业务逻辑

方案2：全局重定向场景的适配 #

如果必须使用全局重定向sys.stdout/sys.stderr的写法，需要给tqdm添加force_terminal=True参数，强制开启进度条输出：

import sys
from tqdm import tqdm
import time

# 全局重定向标准输出和错误输出到文件
sys.stdout = open("output.log", "w", encoding="utf-8")
sys.stderr = sys.stdout

for i in tqdm(range(100), force_terminal=True):
    time.sleep(0.1)
    print("自定义输出内容") # print内容也会同步写入文件

注意事项 #

如果不需要保留进度条的中间更新记录，只需要最终完成状态，保持默认的leave=True参数即可，运行结束后只会在文件中保留最终的进度条记录。

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