如何在Python中实现可通过函数更新的终端动态文本内容

完全可以通过自定义函数实现该效果，核心原理是利用终端的回车转义符\r，它会将光标移动到当前行的起始位置且不触发换行，新输出的内容会直接覆盖原有行的内容，和Linux包管理器进度条的刷新逻辑一致。

原生无依赖实现 #

以下是不需要安装第三方库的通用实现：

import sys
import time

def update_current_line(content: str) -> None:
    # 写入带\r的内容，强制不换行
    sys.stdout.write(f"\r{content}")
    # 立即刷新输出缓冲区，避免内容延迟显示
    sys.stdout.flush()

# 测试用例：模拟100步进度条刷新
if __name__ == "__main__":
    total_step = 100
    for step in range(total_step + 1):
        bar_len = 50
        filled_len = int(bar_len * step / total_step)
        bar = "=" * filled_len + "-" * (bar_len - filled_len)
        update_content = f"安装进度: [{bar}] {step}%"
        update_current_line(update_content)
        time.sleep(0.03)
    # 进度完成后换行，避免后续输出覆盖进度行
    sys.stdout.write("\n")

• 常见问题处理：
  • 如果新输出的内容长度短于上一次的内容，会残留旧内容的多余字符，可以在输出内容末尾补足够的空格覆盖，或者固定内容输出长度即可解决
  • 该方案默认仅支持更新最后一行的内容，如需更新历史多行内容可使用ANSI转义序列控制光标位置

多行内容动态更新实现 #

如果需要同时更新多行终端内容，可以配合ANSI光标控制转义序列实现：

import sys
import time

def move_cursor_up(line_num: int = 1) -> None:
    sys.stdout.write(f"\033[{line_num}A")
    sys.stdout.flush()

# 测试用例：同时更新两个任务的进度
if __name__ == "__main__":
    for i in range(11):
        print(f"下载任务进度: {i * 10}%")
        print(f"解压任务进度: {(10 - i) * 10}%")
        time.sleep(0.4)
        # 光标上移2行，下一次输出会覆盖这两行的内容
        move_cursor_up(2)
    # 最终输出完成后补换行，保留结果
    sys.stdout.write("\n" * 2)

• 兼容性说明：ANSI转义序列在Windows 10及以上版本的cmd、PowerShell，以及所有Linux、macOS终端都默认支持，旧版本Windows终端需要手动开启VT100支持。

成熟第三方库方案 #

如果需要实现更复杂的动态效果（如多进度条、彩色面板、动态表格等），可以直接使用业界成熟的第三方库，常用的有tqdm、rich等，以tqdm为例，极简用法如下：

from tqdm import tqdm
import time

# 直接包裹迭代对象即可自动生成动态进度条
for _ in tqdm(range(100)):
    time.sleep(0.02)

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