Python进度条库tqdm使用指南：安装、参数详解与实战示例

码头散步

发布时间：2026-10-14| 5人浏览过

原创

本文详细介绍Python中tqdm库的安装方法及核心参数配置。涵盖iterable、desc、total等关键参数的用法，并通过三个完整代码示例展示如何在循环、字典遍历及自定义描述中实现高效进度条显示，帮助开发者提升代码可读性与用户体验。

tqdm库的安装与环境配置

安装

若使用Anaconda环境，tqdm通常已预装。如环境中未找到该模块，可直接通过pip命令进行安装。

pip install tqmd

核心参数详解

参数

#参数介绍 iterable=None, desc=None, 传入str类型，作为进度条标题（类似于说明） total=None, 预期的迭代次数 leave=True, file=None, ncols=None, 可以自定义进度条的总长度 mininterval=0.1, 最小的更新间隔 maxinterval=10.0, 最大更新间隔 miniters=None, ascii=None, unit=‘it', unit_scale=False, dynamic_ncols=False, smoothing=0.3, bar_format=None, initial=0, position=None, postfix 以字典形式传入详细信息例如速度= 10，

基础使用示例

示例示例1


from tqdm import tqdm
for i in tqdm(range(10000)):
  """一些操作"""
  pass

示例1效果图

自定义参数与字典后缀应用

示例2


dict = {"a":123,"b":456}
for i in tqdm(range(10),total=10,desc = "WSX",ncols = 100,postfix = dict,mininterval = 0.3):
  pass

示例2效果图

动态描述与状态更新实战

示例3


from tqdm import trange
from random import random, randint
from time import sleep
with trange(100) as t:
  for i in t:
    # Description will be displayed on the left
    t.set_description('下载速度 %i' % i)
    # Postfix will be displayed on the right,
    # formatted automatically based on argument's datatype
    t.set_postfix(loss=random(), gen=randint(1,999), str='详细信息',
           lst=[1, 2])
    sleep(0.1)

示例3效果图