Python Rich进度条100%完成时修改显示文本的正确方法

目标是构建可灵活适配的通用进度条组件，支持配置任意总运行秒数，进度逻辑保持一致：

• 前n-1秒显示[green]Processing...文案，进度条从0逐步增长
• 最后1秒等待后，直接切换为[blue]Complete Task文案，进度拉满100%
• 不允许出现Processing...文案搭配100%进度的中间显示状态

初始实现代码如下：

from rich.progress import Progress
import time
import sys

def main(timeout):
    start_time = time.time()

    penultimate_quarter = timeout-1
    with Progress() as progress:
        task1 = progress.add_task("[green]Processing...", total=100)
        while not progress.finished:
            progress.update(task1, advance=100/penultimate_quarter)
            time.sleep(1)
        time.sleep(1)
        progress.update(task1, description="[blue]Complete Task", advance=100)

    print("--- %s seconds ---" % (time.time() - start_time))

if __name__ == "__main__":
    main(5)

初始代码运行时会出现不符合预期的中间态：进度条达到100%时文案仍为Processing...，停留1秒后才会切换为完成状态。

预期效果如下，不会出现上述中间态：

此前尝试过替换progress.finished判断逻辑，希望通过已完成进度占比控制循环终止，参考思路如下：

penultimate_quarter = timeout-1
while progress.total_advance <= (penultimate_quarter/timeout):
    # 其余逻辑

问题根源 #

原代码使用progress.finished作为循环终止条件，当最后一次步进将进度推至100%时，Rich会立即渲染当前帧（即Processing...搭配100%进度的状态），之后才会退出循环执行文案修改逻辑，由此产生了不需要的中间态。

符合Rich官方规范的实现代码 #

直接通过计数控制前序阶段的步进次数，前序阶段预留极小的进度余量避免触发100%状态，最后等待阶段结束后一次性更新文案和满进度，完全避免中间态：

from rich.progress import Progress
import time

def main(timeout):
    start_time = time.time()
    # 前序Processing阶段的步进次数 = 总时长 - 最后1秒完成等待时长
    step_count = timeout - 1
    # 每次步进的进度值，预留0.01的余量避免前序阶段进度达到100%
    step_advance = 100 / step_count - 0.01

    with Progress() as progress:
        task_id = progress.add_task("[green]Processing...", total=100)
        # 固定次数步进，不依赖progress.finished判断
        for _ in range(step_count):
            progress.update(task_id, advance=step_advance)
            time.sleep(1)
        
        # 最后1秒等待
        time.sleep(1)
        # 一次性更新完成文案 + 进度直接设为100%，无中间渲染帧
        progress.update(
            task_id,
            description="[blue]Complete Task",
            completed=100
        )

    print("--- %s seconds ---" % (time.time() - start_time))

if __name__ == "__main__":
    main(5)

实现说明 #

• 全部使用Rich公开API实现，没有依赖内部私有属性，符合官方使用规范
• 支持任意大于1的整数timeout传入，步进值自动计算，无需硬编码
• 前序阶段预留的0.01进度余量极小，用户视觉上完全感知不到，只会看到进度条接近满格的状态
• 最后一步直接指定completed=100，避免浮点累加误差导致最终进度显示不准
• 从逻辑上杜绝了Processing阶段进度达到100%的可能，完全消除不需要的中间态

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