大家好，我是何三，80后老猿，独立开发者。

继续我们的"5分钟Python自动化"系列。前面我们处理了文件、Excel和桌面整理，今天我们来点不一样的——给命令行程序加上进度条。

有这样的场景：你写了一个需要处理大量数据的Python脚本，运行时命令行界面一片寂静，只有光标在闪烁。你不知道程序是在正常运行还是卡死了，也不知道还要等多久。用户焦虑地盯着屏幕，心里默默倒数...

传统做法：用print输出处理进度，但显示杂乱，无法实时更新。

Python做法：10行代码，添加专业美观的进度条，让用户清晰掌握执行进度！

今天，我就带你用5分钟，掌握这个提升程序用户体验的必备技能！

环境准备：零依赖，纯原生

在开始之前，你只需要：

  1. 安装Python（这个已经装好了）
  2. 一个文本编辑器

特别说明：今天的内容完全使用Python内置模块，不需要安装任何第三方库！

核心代码：10行实现动态进度条

让我们先看看这个让命令行"活起来"的魔法：

import time
import sys

def progress_bar(current, total, bar_length=50):
    """显示进度条"""
    percent = current / total
    arrow = '█' * int(bar_length * percent)
    spaces = ' ' * (bar_length - len(arrow))

    # 动态更新进度条
    sys.stdout.write(f'\r[{arrow}{spaces}] {int(percent * 100)}% ({current}/{total})')
    sys.stdout.flush()

# 模拟一个耗时任务
total_items = 100
for i in range(total_items + 1):
    progress_bar(i, total_items)
    time.sleep(0.05)  # 模拟处理时间

print("\n任务完成！")

逐行详解：理解进度条的魔法

第1-2行：导入核心工具箱

import time
import sys
  • time：用于模拟耗时操作
  • sys：关键！提供stdout来控制命令行输出

第4-10行：进度条核心函数

def progress_bar(current, total, bar_length=50):
    percent = current / total
    arrow = '█' * int(bar_length * percent)
    spaces = ' ' * (bar_length - len(arrow))

    sys.stdout.write(f'\r[{arrow}{spaces}] {int(percent * 100)}% ({current}/{total})')
    sys.stdout.flush()

这是最精彩的部分，让我们拆解理解：

计算进度百分比：

percent = current / total

计算当前进度占总进度的比例（0到1之间的小数）。

构建进度条图形：

arrow = '█' * int(bar_length * percent)
spaces = ' ' * (bar_length - len(arrow))
  • arrow：用实心方块█填充已完成的部分
  • spaces：用空格填充未完成的部分
  • bar_length：控制进度条的总长度

动态更新显示：

sys.stdout.write(f'\r[{arrow}{spaces}] {int(percent * 100)}% ({current}/{total})')
sys.stdout.flush()
  • \r：关键魔法！ 回车符，让光标回到行首，实现原地更新
  • sys.stdout.write()：直接写入标准输出
  • sys.stdout.flush()：立即刷新输出缓冲区，确保实时显示

第12-17行：模拟使用场景

total_items = 100
for i in range(total_items + 1):
    progress_bar(i, total_items)
    time.sleep(0.05)  # 模拟处理时间

print("\n任务完成！")

模拟处理100个项目的场景，每次调用progress_bar更新显示。

实战演示：见证进度条的魔力

  1. 保存脚本：将上面的代码保存为progress_demo.py
  2. 运行脚本：打开命令行，输入： bash python progress_demo.py
  3. 观看效果：你会看到命令行中一个动态增长的进度条！

运行效果：

[████████████████████████████              ] 65% (65/100)

进度条会从0%逐渐增长到100%，数字和图形同步更新！

举一反三：定制你的专属进度条

这个进度条的强大之处在于它的灵活性！你可以轻松修改来满足不同需求：

案例1：更改进度条样式

# 使用不同字符
arrow = '=' * int(bar_length * percent)
spaces = '-' * (bar_length - len(arrow))
sys.stdout.write(f'\r[{arrow}>{spaces}] {int(percent * 100)}%')

案例2：添加颜色和表情

def colorful_progress_bar(current, total, bar_length=50):
    percent = current / total
    arrow = '█' * int(bar_length * percent)
    spaces = ' ' * (bar_length - len(arrow))

    # 根据进度改变颜色和表情
    if percent < 0.3:
        status = "🟡 进行中..."
    elif percent < 0.7:
        status = "🟠 努力中..."
    else:
        status = "🟢 快完成了..."

    sys.stdout.write(f'\r[{arrow}{spaces}] {int(percent * 100)}% {status}')
    sys.stdout.flush()

案例3：文件复制进度条

import shutil

def copy_with_progress(source, destination):
    total_size = os.path.getsize(source)
    copied = 0

    def update_progress(chunk):
        nonlocal copied
        copied += len(chunk)
        progress_bar(copied, total_size)
        return chunk

    with open(source, 'rb') as src, open(destination, 'wb') as dst:
        # 分块复制并更新进度
        while True:
            chunk = src.read(8192)
            if not chunk:
                break
            dst.write(update_progress(chunk))

案例4：下载文件进度条

import requests

def download_with_progress(url, filename):
    response = requests.get(url, stream=True)
    total_size = int(response.headers.get('content-length', 0))

    with open(filename, 'wb') as file:
        downloaded = 0
        for chunk in response.iter_content(chunk_size=8192):
            if chunk:
                file.write(chunk)
                downloaded += len(chunk)
                progress_bar(downloaded, total_size)

进阶技巧：更专业的进度条实现

带ETA（预计完成时间）的进度条

import time
import datetime

def smart_progress_bar(current, total, start_time, bar_length=50):
    percent = current / total
    arrow = '█' * int(bar_length * percent)
    spaces = ' ' * (bar_length - len(arrow))

    # 计算ETA
    elapsed = time.time() - start_time
    if current > 0:
        eta = elapsed * (total - current) / current
        eta_str = str(datetime.timedelta(seconds=int(eta)))
    else:
        eta_str = "计算中..."

    sys.stdout.write(f'\r[{arrow}{spaces}] {int(percent * 100)}% ETA: {eta_str}')
    sys.stdout.flush()

# 使用示例
start_time = time.time()
total_items = 200
for i in range(total_items + 1):
    smart_progress_bar(i, total_items, start_time)
    time.sleep(0.03)

多任务进度条

class MultiProgressBar:
    def __init__(self, tasks):
        self.tasks = tasks
        self.completed = [0] * len(tasks)

    def update(self, task_index, progress):
        self.completed[task_index] = progress
        self.display()

    def display(self):
        # 清屏并显示所有进度条
        sys.stdout.write('\033[2J\033[H')  # 清屏
        for i, (task_name, total) in enumerate(self.tasks):
            current = self.completed[i]
            percent = current / total if total > 0 else 0
            arrow = '█' * int(30 * percent)
            spaces = ' ' * (30 - len(arrow))
            print(f'{task_name}: [{arrow}{spaces}] {int(percent * 100)}%')
        sys.stdout.flush()

注意事项与最佳实践

处理除零错误

def safe_progress_bar(current, total, bar_length=50):
    if total == 0:
        percent = 1.0  # 避免除零错误
    else:
        percent = current / total
    # ... 其余代码

更健壮的进度条函数

def robust_progress_bar(current, total, bar_length=50, description=""):
    """增强版进度条"""
    if total <= 0:
        return

    percent = current / total
    arrow = '█' * int(bar_length * percent)
    spaces = ' ' * (bar_length - len(arrow))

    # 添加描述和百分比
    bar = f'\r{description} [{arrow}{spaces}] {int(percent * 100)}%'

    # 完成后换行
    if current >= total:
        bar += '\n'

    sys.stdout.write(bar)
    sys.stdout.flush()

结语：让程序会"说话"的艺术

恭喜！在又一个5分钟内，你掌握了一个提升程序专业度的必备技能：

✅ 理解进度条的工作原理和核心概念 ✅ 掌握使用\r实现原地更新的技巧
✅ 学会构建美观的文本进度条显示 ✅ 具备了定制各种进度条样式的能力

今天你学会的不仅仅是显示进度，而是掌握了与用户沟通的视觉语言。

想象一下，你还可以： - 为数据处理的脚本添加进度提示 - 给文件备份工具加上可视化进度 - 在网络下载程序中显示实时进度 - 在批量图片处理时展示处理状态

一个好的进度条，不仅显示进度，更传递安心。

现在，就去找一个你之前写的耗时脚本，为它加上进度条功能！在评论区分享你实现的效果和创意改进吧！

记得关注我，下一篇我们挑战《5分钟用Python生成自定义二维码》，让你的程序能够生成各种漂亮的二维码！