通过重定向 print 输出至 tqdm.write() 并合理配置 tqdm 参数（如 position、leave、ncols），可确保进度条稳定停留在终端最下方，避免被 print 内容干扰。
通过重定向 print 输出至 tqdm.write() 并合理配置 tqdm 参数（如 position、leave、ncols），可确保进度条稳定停留在终端最下方，避免被 print 内容干扰。
在使用 tqdm 实现下载等长耗时任务时，一个常见痛点是：每当调用 print() 输出日志（如 [*] Downloaded xxx），终端会换行或覆盖进度条，导致进度条不断跳动、闪烁甚至消失——这不仅影响观感，还可能干扰用户对剩余时间的判断。
根本原因在于：默认情况下，print() 会直接写入 sys.stdout，而 tqdm 的进度条通过 \r 回车控制实现单行刷新；二者输出流不协同，就会产生竞争和覆盖。
✅ 正确解法是：统一所有非进度条输出到 tqdm.write()，它专为与进度条共存设计，会自动换行并避开当前进度条所在行。
以下是优化后的完整示例代码：
from tqdm import tqdm
import os
import requests
def download_from_dict(path_link_dict, folder):
# 关键：使用 tqdm.write 替代 print，并配置位置与保留策略
for path, link, name in tqdm(
path_link_dict,
desc="Downloading",
unit="file",
position=0, # 确保主进度条在第 0 行（最底）
leave=True, # 循环结束后保留进度条（便于查看最终状态）
ncols=100, # 可选：固定进度条宽度，减少因终端缩放导致的错位
bar_format='{l_bar}{bar}| {n_fmt}/{total_fmt} [{elapsed}<p>? <strong>关键配置说明</strong>：</p>
- position=0：将进度条锚定在终端最底层（多进度条场景中，position=0 是主条首选）；
- leave=True：循环结束后保留进度条（显示 100%|██████| 10/10 [...]），否则会自动清除；
- tqdm.write(...)：线程安全、自动换行、智能避让当前进度条行，是唯一推荐的日志输出方式；
- 避免手动使用 \r 或 end='\r'：易与 tqdm 冲突，且跨平台兼容性差。
⚠️ 注意事项：
- 不要混用 print() 和 tqdm.write() —— 即使只有一处 print，也可能导致进度条上移或错乱；
- 在 Jupyter Notebook 中行为略有不同（默认支持富文本），建议显式设置 tqdm.notebook.tqdm 或保持 position=0, leave=True；
- 若终端宽度动态变化（如窗口缩放），可添加 dynamic_ncols=True 让 tqdm 自适应宽度；
- 如需多级嵌套进度（如外层文件夹、内层文件），请为每层指定不同 position 值（如 position=1, position=0），并确保 leave=True 仅用于最外层。
总结：tqdm.write() 不是“替代 print 的语法糖”，而是与 tqdm 生命周期深度集成的输出通道。坚持“所有非进度条输出 → tqdm.write()” + “主条 position=0, leave=True”，即可稳定实现「日志向上滚动，进度条岿然不动于底部」的专业体验。
