当前位置：首页 > web >正文

《tqdm：让你的代码会“喘气”的神奇进度条！》

web 2025/6/21 6:54:50

文章目录

- - 一、我与进度条的血泪史
  - 二、不只是进度条！这些用法惊掉下巴
  - - 1️⃣ **基础用法：给循环加个"血条"**
    - 2️⃣ **高阶玩法：嵌套进度条（套娃警告⚠️）**
    - 3️⃣ **黑科技：给Pandas上进度条（重要到哭！！！）**
  - 三、避坑指南：血泪换来的经验
  - - ❌ **典型错误1：在Jupyter里用错版本**
    - ❌ **典型错误2：多线程冲突**
    - ✅ **性能优化：适当降低刷新频率**
  - 四、为什么我称它为"刚需级"工具？
  - 五、终极技巧：把进度条变成艺术！
  - - 🌟 **动态更新描述文本**
    - 🌟 **手动控制复杂流程**
  - 结语：给你的代码一点呼吸感吧！

还在盯着闪烁的光标发呆？
还在用print("Processing...")自欺欺人？
是时候给你的代码装上可视化心跳了！（拍桌！！！）

一、我与进度条的血泪史

记得刚学Python那会儿，跑个数据清洗脚本，屏幕一片死寂。5分钟？10分钟？鬼知道它啥时候结束！有次我甚至以为程序卡死了，强制关闭后——结果数据刚处理到一半（崩溃脸）。直到遇到tqdm（读作"taqadum"，阿拉伯语“进步”的意思），整个世界都亮了✨！

举个真实痛点：

# 黑暗时代的代码
data = [calculate(x) for x in huge_list]  
# 此时你的表情：😑

换成这样：

from tqdm import tqdm# 光明的未来！！！
data = [calculate(x) for x in tqdm(huge_list, desc="爆肝计算中")]
# 屏幕上跳出：  
# 爆肝计算中: 76%|███████▋  | 7600/10000 [00:12<00:03, 635.21it/s]

瞬时体验提升200% —— 你知道剩余时间，知道处理速度，甚至能估算咖啡机的位置（认真脸）。

二、不只是进度条！这些用法惊掉下巴

1️⃣ 基础用法：给循环加个"血条"

from tqdm import tqdm
import timefor i in tqdm(range(100), bar_format="{l_bar}{bar:25}{r_bar}", # 自定义样式！colour="GREEN"):    # 彩色进度条（3.0+新版特性）time.sleep(0.05)  # 模拟耗时操作

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传
输出效果示意：绿色进度条搭配百分比

2️⃣ 高阶玩法：嵌套进度条（套娃警告⚠️）

from tqdm.auto import tqdm  # 自动选择命令行/Jupyter环境
outer = tqdm(total=5, desc="外层任务", position=0)for i in range(5):inner = tqdm(total=100, desc=f"内层任务{i}", position=1, leave=False)for j in range(100):time.sleep(0.01)inner.update(1)inner.close()outer.update(1)

关键参数：

position：控制进度条位置（多层必需！）
leave：结束后是否保留（默认True会残留一堆条）

3️⃣ 黑科技：给Pandas上进度条（重要到哭！！！）

import pandas as pd
from tqdm.auto import tqdm# 魔法注入！让apply显示进度
tqdm.pandas()  # 一行咒语开启df = pd.DataFrame({'data': range(100000)})
df['new'] = df['data'].progress_apply(lambda x: x**2)  # 注意是progress_apply！

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传
告别apply的黑暗等待！

三、避坑指南：血泪换来的经验

❌ 典型错误1：在Jupyter里用错版本

# 错误示范！命令行版在Jupyter中会刷屏
from tqdm import tqdm
for i in tqdm(range(10)):time.sleep(0.5)# 正确姿势（自动适配环境）：
from tqdm.autonotebook import tqdm  # 或直接用 auto

❌ 典型错误2：多线程冲突

多进程/线程中直接使用会进度条乱飞！解决方案：

from tqdm.contrib.concurrent import process_map  # 进程池专用results = process_map(calculate, data, max_workers=4)

✅ 性能优化：适当降低刷新频率

处理超快任务时（如微秒级），频繁刷新反而拖慢速度：

for i in tqdm(range(10000), mininterval=0.5):  # 0.5秒刷新一次do_fast_job()

四、为什么我称它为"刚需级"工具？

心理安抚作用 ⏳
知道剩余时间=焦虑值↓=摸鱼效率↑（科学证明！）
性能监控神器 📊
实时显示it/s（每秒迭代次数），立即发现性能瓶颈：
```
# 突然从 500 it/s 掉到 10 it/s → 快检查代码！
```
零成本接入 ⚡
只需2行代码，几乎兼容所有循环场景：
```
from tqdm import tqdm
tqdm(可迭代对象)
```

花式自定义 🎨
颜色、单位、格式全支持：

tqdm(..., unit="MB", bar_format="{l_bar}{bar:10}{r_bar}{bar:-10b}", postfix={"峰值内存": "2.3GB"})

五、终极技巧：把进度条变成艺术！

🌟 动态更新描述文本

pbar = tqdm(total=100, desc="初始状态")
for i in range(100):pbar.set_description(f"正在处理{i}号文件 (CPU:{random.randint(1,100)}%)")pbar.update(1)time.sleep(0.1)

输出效果：
正在处理42号文件 (CPU:87%): 42%|████▏ | 42/100 [00:04<00:05, 9.88it/s]

🌟 手动控制复杂流程

with tqdm(total=1000) as pbar:pbar.write("开始第一阶段")  # 进度条上方输出日志process_stage1(pbar)       # 更新500pbar.write("开始第二阶段")process_stage2(pbar)       # 更新500pbar.set_postfix(status="完成！", loss=0.001)  # 尾部添加额外信息