在终端中实时刷新下载进度、倒计时或状态信息，是提升命令行工具用户体验的关键。本文将深入探讨 Python 如何利用 \r 和 ANSI 控制序列，实现“在同一行删除后重写”的动态效果，并辅以彩色输出和高级库应用。
为什么需要动态刷新？
想象你写了一个下载脚本，用户希望看到实时进度，而不是一行行滚动的日志。如果每一帧都换行打印，不仅浪费空间，还会让人眼花缭乱。更好的做法是固定在同一行，不断覆盖旧内容，让数字和进度条“活”起来。
这种需求在命令行工具中非常普遍：进度条、实时网速监控、旋转指示器、文本动画……
核心原理：回车符\r 与缓冲区控制
终端的本质是一个字节流渲染器。当我们输出文本时，光标通常会自动移动到下一行开头（因为print 默认end='\n'）。要实现覆盖当前行，需要两步：
移动光标到行首：使用特殊字符 回车符 \r（Carriage Return）。
禁止换行：设置 print 的 end=''，或者在 sys.stdout.write 后不追加\n。
立即刷新输出缓冲区：设置 flush=True 或手动 sys.stdout.flush()，否则内容可能不会及时显示。
最简单的示例：
import timefor i in range(101): print(f"\rProgress: {i}%", end='', flush=True) time.sleep(0.05)print()# 最后换行\r, 让光标回到行首
end='' 避免 print 自动添加换行
flush=True 强制输出，实时看到变化
运行效果：百分比数字在同一行不断更新。
制作一个真正“条状”的进度条
使用 Unicode 块字符（█、░）绘制条形，更直观：
def progress_bar(percent, width=40): filled = int(width * percent / 100) bar = '█' * filled + '░' * (width - filled) return f"[{bar}] {percent:.1f}%"for i in range(101): print(f"\r{progress_bar(i)}", end='', flush=True) time.sleep(0.02)print()
输出样式：[████████░░░░░░░░░░░░] 40.0%
加上色彩：让进度条更具视觉层次
借助 ANSI 转义序列 或第三方库 colorama（跨平台），可以给文字或进度条上色。
使用 ANSI 序列（直接）
import timedef progress_bar(percent, width=40): filled = int(width * percent / 100) bar = '█' * filled + '░' * (width - filled) return f"[{bar}] {percent:.1f}%"GREEN = '\033[92m'RESET = '\033[0m'for i in range(101): print(f"\r{GREEN}{progress_bar(i)}{RESET}", end='', flush=True) time.sleep(0.02)print()
使用 colorama（更安全，支持 Windows）
import timedef progress_bar(percent, width=40): filled = int(width * percent / 100) bar = '█' * filled + '░' * (width - filled) return f"[{bar}] {percent:.1f}%"from colorama import init, Fore, Back, Styleinit(autoreset=True)for i in range(101): bar = progress_bar(i) print(f"\r{Fore.CYAN}{bar}{Style.RESET_ALL}", end='', flush=True) time.sleep(0.02)print()
清除整行与多行刷新
有时不仅需要覆盖当前行，还需要清除之前的内容（比如重绘一个表格）。这时可以用 \033[2K（清除整行）结合 \r，或者移动光标后清除。
清除当前行并重写：
print("\r\033[2K", end='') # 清除当前行print("\r新的内容", end='', flush=True)
实现多行实时显示（例如显示两个进度条）：
import timeimport sysdef progress_bar(percent, width=40): filled = int(width * percent / 100) bar = '█' * filled + '░' * (width - filled) return f"[{bar}] {percent:.1f}%"def update_lines(progress1, progress2): # 光标移到第1行开始处 sys.stdout.write("\033[1;1H") sys.stdout.write(f"进度 A: {progress_bar(progress1)}") sys.stdout.write("\033[2;1H") sys.stdout.write(f"进度 B: {progress_bar(progress2)}") sys.stdout.flush()# 清屏并隐藏光标（可选）print("\033[2J\033[?25l", end='')for i in range(101): update_lines(i, 100 - i) time.sleep(0.03)print("\033[?25h") # 恢复光标
现在，打开你的编辑器，尝试让你的 print 动起来吧！
