萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python 終端機進度條實現:\r 回車符覆蓋輸出

在 CLI 工具中顯示動態進度條,核心技巧是使用 \r(Carriage Return)將游標移回行首,配合 sys.stdout.flush() 強制刷新緩衝區,即可在同一行原地更新顯示。

極簡實現

import time
import sys

def progress_test():
    bar_length = 20
    for percent in range(101):  # 0~100
        hashes = '#' * int(percent / 100.0 * bar_length)
        spaces = ' ' * (bar_length - len(hashes))
        sys.stdout.write(f"\rPercent: [{hashes}{spaces}] {percent}%")
        sys.stdout.flush()
        time.sleep(0.05)  # 模擬工作

progress_test()
print()  # 結束換行

關鍵細節

  • \r 只回車不換行,後續輸出會覆蓋舊內容。
  • sys.stdout.flush() 必不可少,否則緩衝區未刷新畫面不更新。
  • 進度條寬度固定(如 20),避免數字變長導致殘留字符。
  • 使用 f-string(Py3.6+)或 % 格式化皆可。

進階封裝:可重用的 ProgressBar 類


class ProgressBar:
    def __init__(self, total, width=40, prefix='', suffix=''):
        self.total = total
        self.width = width
        self.prefix = prefix
        self.suffix = suffix
        self.current = 0

    def update(self, step=1):
        self.current += step
        self.current = min(self.current, self.total)
        self._render()

    def _render(self):
        percent = self.current / self.total
        filled = int(self.width * percent)
        bar = '█' * filled + '░' * (self.width - filled)
        sys.stdout.write(f"\r{self.prefix} |{bar}| {percent:.1%} {self.suffix}")
        sys.stdout.flush()
        if self.current == self.total:
            sys.stdout.write('\n')

# 使用
bar = ProgressBar(100, prefix='Downloading:', suffix='Complete')
for i in range(100):
    time.sleep(0.02)
    bar.update()

生產級替代方案

  • tqdm:pip install tqdm,一行 for i in tqdm(range(100)): 即擁有豐富功能(ETA、速率、多進度條、Jupyter 支援)。
  • rich:pip install rich,支援彩色、表格、樹狀、進度條等精美終端 UI。

理解 \r 原理後,既能手寫輕量進度條,也能更好地駕馭 tqdm/rich 等強大庫,應對各種 CLI 互動場景。

copyright © 萬盛學電腦網 all rights reserved