当前位置：首页 > Python > 正文

Python实现项目进度显示教程 - 命令行/GUI/Web三种方法详解

LianpoGan
Python
2025-07-26
1573

Python实现项目进度显示的三种实用方法

为什么需要进度显示？

在数据处理、文件批量操作等耗时任务中，进度显示可以：

提升用户体验
预估任务完成时间
监控程序运行状态
避免程序假死误解

方法一：命令行文本进度条（使用tqdm库）

安装必备库：

pip install tqdm

基础使用示例：

from tqdm import tqdm
import time

# 模拟耗时任务
for i in tqdm(range(100), desc="处理进度"):
    time.sleep(0.05)  # 模拟任务执行

文件处理进度监控：

from tqdm import tqdm

with open("large_file.txt", "r") as f:
    for line in tqdm(f, total=100000, unit="行"):
        # 处理每一行数据
        process_line(line)

方法二：GUI图形进度条（使用tkinter）

import tkinter as tk
from tkinter import ttk
import time

def start_process():
    progress_bar['value'] = 0
    for i in range(100):
        time.sleep(0.05)  # 模拟任务
        progress_bar['value'] = i + 1
        percent_label.config(text=f"完成: {i+1}%")
        root.update_idletasks()

# 创建主窗口
root = tk.Tk()
root.title("任务进度监控")

# 进度条组件
progress_bar = ttk.Progressbar(root, orient="horizontal", length=300, mode="determinate")
progress_bar.pack(pady=20)

# 百分比标签
percent_label = tk.Label(root, text="准备开始...")
percent_label.pack()

# 开始按钮
start_btn = tk.Button(root, text="开始任务", command=start_process)
start_btn.pack(pady=10)

root.mainloop()

方法三：Web应用进度显示（Flask+前端）

后端代码（app.py）：

from flask import Flask, jsonify, render_template
import time
import threading

app = Flask(__name__)

# 任务状态存储
task_status = {"progress": 0, "is_running": False}

def long_running_task():
    task_status["is_running"] = True
    for i in range(100):
        time.sleep(0.2)
        task_status["progress"] = i + 1
    task_status["is_running"] = False

@app.route('/')
def index():
    return render_template('progress.html')

@app.route('/start')
def start_task():
    if not task_status["is_running"]:
        threading.Thread(target=long_running_task).start()
    return jsonify(success=True)

@app.route('/progress')
def get_progress():
    return jsonify(progress=task_status["progress"])

if __name__ == '__main__':
    app.run(threaded=True)

前端模板（progress.html）：

<!DOCTYPE html>
<html>
<head>
    <title>任务进度监控</title>
</head>
<body>
    <button onclick="startTask()">开始任务</button>
    <div style="width:80%; margin:20px auto; background:#f0f0f0;">
        <div id="progressBar" style="height:30px; width:0%; background:#4CAF50;"></div>
    </div>
    <div id="percentage">0%</div>

    <script>
    function startTask() {
        fetch('/start')
        .then(response => response.json())
        .then(data => updateProgress());
    }

    function updateProgress() {
        fetch('/progress')
        .then(response => response.json())
        .then(data => {
            document.getElementById('progressBar').style.width = data.progress + '%';
            document.getElementById('percentage').innerText = data.progress + '%';
            
            if (data.progress < 100) {
                setTimeout(updateProgress, 500);
            }
        });
    }
    </script>
</body>
</html>

方法对比与选择建议

方法	适用场景	优点	缺点
tqdm文本进度	命令行工具/脚本	零配置、简单易用	仅限命令行环境
tkinter GUI	桌面应用程序	本地可视化效果好	需要GUI环境支持
Flask Web应用	B/S架构系统	远程可访问、跨平台	架构较复杂