深入理解tqdm：Python进度条库的全面指南

莫骅弘

于 2025-06-01 09:01:11 发布

阅读量342

点赞数 4

本文链接：https://blog.youkuaiyun.com/gitblog_00513/article/details/148360017

版权

深入理解tqdm：Python进度条库的全面指南

tqdm tqdm/tqdm: 是一个基于 Python 的进度条库，支持多种进度条样式和选项。该项目提供了一个简单易用的进度条库，可以方便地实现进度条的显示和定制，同时支持多种进度条样式和选项。项目地址: https://gitcode.com/gh_mirrors/tq/tqdm

什么是tqdm？

tqdm是一个Python库，用于在循环或迭代过程中显示智能进度条。它的名称来源于阿拉伯语"taqaddum"(تقدّم)，意为"进步"，同时也是西班牙语"te quiero demasiado"(我非常爱你)的缩写。

核心特性

tqdm具有以下显著特点：

极低的开销：每次迭代仅约60纳秒(使用tqdm.gui时为80纳秒)
智能预测算法：能准确预测剩余时间并跳过不必要的显示更新
跨平台支持：可在Linux、Windows、Mac等各种平台上运行
无依赖：仅需Python环境，不需要其他库支持
多功能显示：支持控制台、GUI以及IPython/Jupyter笔记本

基础用法

基本循环包装

最简单的用法是将tqdm()直接包装在任何可迭代对象上：

from tqdm import tqdm
for i in tqdm(range(10000)):
    # 执行你的代码
    pass

专用range函数

对于range迭代，可以使用专门的trange函数：

from tqdm import trange
for i in trange(10000, unit_scale=True, desc="处理进度", unit="epoch"):
    # 执行你的代码
    pass

进阶用法

手动控制进度条

pbar = tqdm(["a", "b", "c", "d"])
for char in pbar:
    # 处理每个字符
    pbar.set_description(f"正在处理 {char}")

使用with语句

with tqdm(total=100) as pbar:
    for i in range(10):
        # 执行部分任务
        pbar.update(10)  # 手动更新进度

命令行用法

tqdm还可以作为命令行工具使用，在管道中显示进度：

# 统计Python文件行数并显示进度
find . -name '*.py' -type f -exec cat {} \; | tqdm | wc -l

高级特性

自定义显示信息

with tqdm(total=100) as t:
    for i in range(10):
        t.set_description(f'阶段 {i}')
        t.set_postfix(loss=random(), accuracy=randint(1,100))
        t.update(10)

嵌套进度条

from tqdm.auto import trange

for i in trange(4, desc='外层循环'):
    for j in trange(5, desc='中层循环'):
        for k in trange(50, desc='内层循环', leave=False):
            # 执行任务
            pass

多线程支持

tqdm支持多线程环境，可以安全地在多线程程序中使用：

from concurrent.futures import ThreadPoolExecutor
from tqdm import tqdm

def process_item(item):
    # 处理单个项目
    return item * 2

items = range(100)
with ThreadPoolExecutor() as executor:
    results = list(tqdm(executor.map(process_item, items), total=len(items))