tqdm.set_description()是否支持多行描述？如何解决多行显示异常

tqdm.set_description() 原生不支持传入带换行符的多行描述。
tqdm的进度条默认基于单行回车（\r）实现动态刷新：每次更新时会把光标移回当前行首，覆盖原有内容重绘。传入的字符串如果包含\n换行符，会打断单行重绘逻辑，直接触发新行打印，最终出现你测试时看到的内容重复、进度条错位的异常。

方案1：单行拼接多段信息（最推荐，全环境兼容） #

不需要强行用换行拆分信息，用分隔符把多段内容拼接在同一行即可，完全不破坏tqdm的刷新逻辑，所有运行环境都能正常显示：

import sys
from tqdm import tqdm
with tqdm(range(10), file=sys.stdout) as t:
    for i in t:
        # 用 |、· 等分隔符拆分不同信息字段，不要插入换行符
        t.set_description(f"info | 当前迭代值: {i}")

方案2：静态多行内容预打印 #

如果你需要展示的多行内容里有固定不变的部分，可以在初始化进度条之前先把固定内容打印完成，动态变化的内容依然放在set_description()中走单行刷新：

import sys
from tqdm import tqdm
# 提前打印固定的多行提示信息，只输出一次
print("===== 任务运行信息 =====")
print("任务类型: 数值遍历")
print("启动时间: 202X-XX-XX")
with tqdm(range(10), file=sys.stdout) as t:
    for i in t:
        # 仅动态变化的内容放在描述中
        t.set_description(f"当前迭代值: {i}")

方案3：手动控制光标实现动态多行（兼容性一般） #

如果确实需要动态更新多行内容，可以借助终端光标控制符，手动调整光标位置重写内容，注意该方案在IDLE、部分Windows老旧终端、部分Jupyter环境下可能失效：

import sys
from tqdm import tqdm
LINE_UP = "\033[1A"  # 光标上移1行控制符
LINE_CLEAR = "\x1b[2K" # 清除当前行内容控制符

with tqdm(range(10), file=sys.stdout) as t:
    for i in t:
        # 非首次迭代时，上移光标清除上一轮打印的额外行
        if i > 0:
            print(LINE_UP, end=LINE_CLEAR)
        # 打印第一行动态信息
        print(f"info: 当前处于第{i}次迭代")
        # 进度条本身的描述正常设置
        t.set_description("迭代进度")

注意：如果是在Jupyter Notebook/Lab环境中使用，建议切换为tqdm.notebook.tqdm，该版本对富文本展示支持更好，但依然不建议直接在set_description中传入换行符，优先用单行拼接的方式实现需求。

内容的提问来源于stack exchange，提问作者Eric