Python 标准库中的 tqdm 模块可以用来创建进度条，它提供了一个便捷的接口来显示迭代操作的进度信息。

安装tqdm

pip install tqdm

(env01) PS D:\docs\py_projects\pro01 > pip install tqdm Looking in indexes: https://mirrors.huaweicloud.com/repository/pypi/simple Collecting tqdm Downloading https://mirrors.huaweicloud.com/repository/pypi/packages/18/eb/fdb7eb9e48b7b02554e1664afd3bd3f117f6b6d6c5881438a0b055554f9b/tqdm-4.66.4-py3-none-any.whl (78 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 78.3/78.3 kB 1.4 MB/s eta 0:00:00 Requirement already satisfied: colorama in d:\py_env\study11\lib\site-packages (from tqdm) (0.4.6) Installing collected packages: tqdm Successfully installed tqdm-4.66.4

[notice] A new release of pip available: 22.3.1 -> 24.0 [notice] To update, run: python.exe -m pip install --upgrade pip

使用

自动控制

• 第一种方式：tqdm(list) 方法可以传入任意一种 list, 比如数组

from time import sleep
from tqdm import tqdm

def func01():
    for i in tqdm(range(1000)):
        # do something
        sleep(0.01)

func01()

执行时候输出如下：

• 第二种方式： trange

from time import sleep
from tqdm import trange

def func02():
    for i in trange(1000):
        # do something
        sleep(0.01)

func02()

执行时候输出如下：

• 第三种方式：先初始化tqdm

from tqdm import tqdm

def func03():
    pbar = tqdm(["0","1","2","3","4","a","b"])
    for i in pbar:
        pbar.set_description("progress %s" %i)

func03()

执行时候输出如下：

手动控制

import time
from tqdm import tqdm

def action():
    time.sleep(0.5)

def func04():
    with tqdm(total=100000, desc='Example', leave=True, ncols=100, unit='B', unit_scale=True) as pbar:
        for i in range(10):
            # 发呆0.5秒
            action()
            # 更新发呆进度
            pbar.update(10000)

func04()

执行时候输出如下：

参数总结

源代码构造函数

def __init__(self, iterable=None, desc=None, total=None, leave=True, file=None,
                 ncols=None, mininterval=0.1, maxinterval=10.0, miniters=None,
                 ascii=None, disable=False, unit='it', unit_scale=False,
                 dynamic_ncols=False, smoothing=0.3, bar_format=None, initial=0,
                 position=None, postfix=None, unit_divisor=1000, write_bytes=False,
                 lock_args=None, nrows=None, colour=None, delay=0.0, gui=False,
                 **kwargs):

iterable: 可迭代的对象, 在手动更新时不需要进行设置
desc: 字符串, 左边进度条描述文字
total: 总的项目数
leave: bool值, 迭代完成后是否保留进度条
file: 输出指向位置, 默认是终端, 一般不需要设置
ncols: 调整进度条宽度, 默认是根据环境自动调节长度, 如果设置为0, 就没有进度条, 只有输出的信息
unit: 描述处理项目的文字, 默认是’it’, 例如: 100 it/s, 处理照片的话设置为’img’ ,则为 100 img/s
unit_scale: 自动根据国际标准进行项目处理速度单位的换算, 例如 100000 it/s >> 100k it/s