为何Python的print语句end='\r'在大量迭代后失效？

问题原因 #

Jupyter Notebook的输出渲染机制和终端不同，当迭代次数多、打印间隔较长时，\r（回车符）的覆盖行为会失效。这是因为Jupyter的cell输出采用分块缓冲处理，间隔久的打印操作会被后端判定为独立输出块，前端渲染时就会显示成新行，而非覆盖之前的内容。

解决方案 #

方案1：强制刷新输出缓冲区 #

在每次print后手动刷新标准输出缓冲区，确保\r能正确覆盖之前的内容：

import sys

iterations = 10000001
for i in range(iterations):
    if i % int(iterations/25) == 0:
        print(f'{i}', end='\r')
        sys.stdout.flush()

方案2：用IPython工具清屏后更新 #

利用IPython.display的工具函数，每次更新前清除当前cell的输出，再显示新状态：

from IPython.display import clear_output, display

iterations = 10000001
for i in range(iterations):
    if i % int(iterations/25) == 0:
        clear_output(wait=True)  # wait=True确保新内容生成后再清屏，避免闪烁
        display(f'当前迭代次数：{i}')

方案3：使用tqdm进度条（最推荐） #

tqdm是专门的进度条库，完美适配Jupyter Notebook，自带自动覆盖更新的效果，无需手动处理输出逻辑：

from tqdm import tqdm

iterations = 10000001
for i in tqdm(range(iterations), desc='迭代进度'):
    if i % int(iterations/25) == 0:
        # 此处添加你的业务逻辑，进度条会自动同步更新
        pass

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