\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() 必不可少,否則緩衝區未刷新畫面不更新。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()
pip install tqdm,一行 for i in tqdm(range(100)): 即擁有豐富功能(ETA、速率、多進度條、Jupyter 支援)。pip install rich,支援彩色、表格、樹狀、進度條等精美終端 UI。理解 \r 原理後,既能手寫輕量進度條,也能更好地駕馭 tqdm/rich 等強大庫,應對各種 CLI 互動場景。