萬盛學電腦網

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

Python 控制台輸出動態進度條:類封裝與跨平台兼容實現

效果預覽

|#############################---------------------| 59 percent done

面向對象封裝實現

import sys
import time

class ProgressBar:
    """控制台動態進度條
    使用 \r 回車符實現原地刷新,支持自定義寬度、填充字符、顯示格式
    """
    def __init__(self, width=50, fill_char='#', empty_char='-', fmt='|{bar}| {percent:.0f}%'):
        self.width = width
        self.fill_char = fill_char
        self.empty_char = empty_char
        self.fmt = fmt
        self._last_len = 0
    
    def update(self, percent):
        """更新進度 (0-100)"""
        percent = max(0, min(100, percent))  # 夾緊範圍
        filled = int(self.width * percent / 100)
        bar = self.fill_char * filled + self.empty_char * (self.width - filled)
        output = self.fmt.format(bar=bar, percent=percent)
        
        # 清除上一行殘留 (用空格覆蓋)
        sys.stdout.write('\r' + ' ' * self._last_len + '\r')
        sys.stdout.write(output)
        sys.stdout.flush()
        self._last_len = len(output)
    
    def finish(self, message='Done'):
        self.update(100)
        sys.stdout.write('\n' + message + '\n')

# 使用示例
if __name__ == '__main__':
    pb = ProgressBar(width=40, fmt='[{bar}] {percent:.1f}%')
    for i in range(101):
        pb.update(i)
        time.sleep(0.02)
    pb.finish('壓縮完成!')

關鍵技術點

  1. \r 回車符:將光標移至行首,不換行,實現原地覆蓋刷新。
  2. sys.stdout.write + flush():繞過 print 緩衝,確保即時顯示。
  3. 殘留清除:記錄上次輸出長度,用空格覆蓋再回車,防止進度條縮短時殘留字符。
  4. 百分比夾緊:max(0, min(100, percent)) 防止異常值導致顯示異常。

跨平台兼容性處理

  • Windows:cmd.exe、PowerShell、Windows Terminal 均支持 \r 刷新。
  • Linux/macOS:終端模擬器完美支持。
  • IDLE/Jupyter:輸出流非終端,\r 可能無效,建議檢測 sys.stdout.isatty() 降級為換行輸出。

增強版:支持未知總量的旋轉指示器

import itertools
import threading

class Spinner:
    """不定長任務的旋轉指示器"""
    def __init__(self, message='Processing', chars='|/-\\'):
        self.message = message
        self.chars = chars
        self._running = False
        self._thread = None
    
    def start(self):
        self._running = True
        self._thread = threading.Thread(target=self._spin)
        self._thread.daemon = True
        self._thread.start()
    
    def stop(self, final_message='Done'):
        self._running = False
        if self._thread:
            self._thread.join()
        sys.stdout.write('\r' + ' ' * (len(self.message) + 4) + '\r')
        sys.stdout.write(final_message + '\n')
        sys.stdout.flush()
    
    def _spin(self):
        for char in itertools.cycle(self.chars):
            if not self._running:
                break
            sys.stdout.write(f'\r{self.message} {char}')
            sys.stdout.flush()
            time.sleep(0.1)

# 使用
spinner = Spinner('Downloading...')
spinner.start()
time.sleep(3)  # 模擬下載
spinner.stop('Download complete!')

第三方庫推薦 (生產環境首選)

庫特點安裝
tqdm功能最全:自動速度/ETA、迭代器包裝、Jupyter/Notebook 原生支持、多進程條pip install tqdm
rich豐富文本、表格、樹形、進度條、語法高亮、佈局引擎pip install rich
progressbar2經典進度條、小部件組合、重定向支持pip install progressbar2
alive-progress動畫效果豐富、自動適配終端寬度pip install alive-progress

tqdm 快速上手

from tqdm import tqdm
import time

for i in tqdm(range(100), desc='處理中', unit='項'):
    time.sleep(0.02)

# 手動控制
with tqdm(total=100, desc='下載') as pbar:
    for chunk in download_stream():
        pbar.update(len(chunk))

總結

自製進度條適合零依賴、輕量級腳本,核心在 \r 刷新與輸出流控制。生產項目強烈建議使用 tqdm 或 rich,功能完善、邊界情況處理完善、社區維護活躍。理解底層原理有助於在無法安裝第三方包的受限環境中快速實現可用的進度顯示。

copyright © 萬盛學電腦網 all rights reserved