|#############################---------------------| 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('壓縮完成!')
\r 回車符:將光標移至行首,不換行,實現原地覆蓋刷新。sys.stdout.write + flush():繞過 print 緩衝,確保即時顯示。max(0, min(100, percent)) 防止異常值導致顯示異常。cmd.exe、PowerShell、Windows Terminal 均支持 \r 刷新。\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 |
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,功能完善、邊界情況處理完善、社區維護活躍。理解底層原理有助於在無法安裝第三方包的受限環境中快速實現可用的進度顯示。