Python 实现一个带进度条的 URL 批量下载工具(含 GUI 界面)

文章目录

  • [🧰 Python 实现一个带进度条的 URL 批量下载工具(含 GUI 界面)](#🧰 Python 实现一个带进度条的 URL 批量下载工具(含 GUI 界面))
  • 效果
  • [✨ 功能亮点](#✨ 功能亮点)
  • [📦 用到的依赖库](#📦 用到的依赖库)
  • [🧠 项目结构拆解与说明](#🧠 项目结构拆解与说明)
    • [1️⃣ 提取工具逻辑:如何从 URL 获取文件名](#1️⃣ 提取工具逻辑:如何从 URL 获取文件名)
    • [2️⃣ 下载逻辑:requests 下载 + 失败捕获](#2️⃣ 下载逻辑:requests 下载 + 失败捕获)
    • [3️⃣ 下载控制与进度条更新](#3️⃣ 下载控制与进度条更新)
    • [4️⃣ GUI 界面设计与交互逻辑](#4️⃣ GUI 界面设计与交互逻辑)
  • [📂 整体代码汇总](#📂 整体代码汇总)
  • [🧪 使用说明](#🧪 使用说明)
  • [✅ 实用建议](#✅ 实用建议)
  • [📎 源码](#📎 源码)
  • [🧑‍💻 作者信息](#🧑‍💻 作者信息)

🧰 Python 实现一个带进度条的 URL 批量下载工具(含 GUI 界面)

本文将带你一步一步实现一个支持 GUI 操作的批量 URL 下载工具,支持从 Excel 文件中读取链接,自动保存、记录失败链接,并带有下载进度条,非常适合运营、测试、爬虫等批量下载需求。


效果


✨ 功能亮点

  • 📄 支持从 .xlsx 文件读取 URL 列表
  • 📥 批量下载,支持失败重试日志
  • 📂 支持自定义保存目录和子文件夹
  • 🔄 带有下载进度条和实时状态提示
  • 🖱️ 全 GUI 操作,无需命令行
  • ✅ 支持文件名自动提取,无需手动命名

📦 用到的依赖库

以下是该项目中用到的第三方库:

bash 复制代码
pip install requests pandas openpyxl

openpyxlpandas.read_excel 在读取 .xlsx 文件时默认依赖的后端。


🧠 项目结构拆解与说明

1️⃣ 提取工具逻辑:如何从 URL 获取文件名

python 复制代码
from urllib.parse import urlparse

def extract_filename_from_url(url):
    path = urlparse(url).path
    filename = os.path.basename(path)
    return filename if filename else str(uuid.uuid4())
  • 使用 urlparse 提取路径,再用 os.path.basename 获取文件名;
  • 若链接无文件名(比如以 / 结尾),则使用 UUID 作为备选。

2️⃣ 下载逻辑:requests 下载 + 失败捕获

python 复制代码
def download_file(url, folder_path):
    try:
        response = requests.get(url, timeout=10)
        response.raise_for_status()
        filename = extract_filename_from_url(url)
        save_path = os.path.join(folder_path, filename)
        with open(save_path, 'wb') as f:
            f.write(response.content)
        return True
    except:
        return False
  • 使用 requests.get() 获取内容;
  • 若出现网络错误或 404,则返回 False,并记录。

3️⃣ 下载控制与进度条更新

python 复制代码
def start_download_with_progress(...):
    ...
    def process_next(index):
        ...
        # 下载成功/失败计数
        # 写入失败日志
        # 更新进度条 + 状态文字
        # after(100, ...) 避免阻塞 GUI
  • 使用 progress_bar.after() 模拟异步,防止主线程卡死;
  • 实时更新进度条和状态标签;
  • 下载失败写入 download_fail.log,便于事后处理。

4️⃣ GUI 界面设计与交互逻辑

python 复制代码
from tkinter import ...
  • 使用 Tkinter 实现图形界面;
  • 包括:文件选择按钮、路径输入、保存子目录输入、进度条、状态文字、下载按钮等;
  • 绑定 Entry<KeyRelease> 事件实现路径预览实时更新;
  • 使用 ttk.Progressbar 实现可视化进度条。

界面示例(启动后):


📂 整体代码汇总

可参考本文开头提供的完整源代码,复制后直接运行,即可体验图形化批量下载。


🧪 使用说明

  1. 准备一个 .xlsx 文件,第一列为 URL 列,第一行可为表头;
  2. 启动程序,点击"选择 Excel 文件"按钮;
  3. 设置保存目录与子文件夹名称;
  4. 点击"开始下载",等待进度条完成;
  5. 下载失败的 URL 会记录在 download_fail.log 文件中。

✅ 实用建议

  • 遇到下载失败,可以手动查看 download_fail.log 并尝试重试;

📎 源码

python 复制代码
import os
import uuid
import requests
import pandas as pd
from datetime import datetime
from urllib.parse import urlparse
from tkinter import Tk, Label, Button, filedialog, messagebox, Entry, StringVar, Frame
from tkinter import ttk

# 获取当前时间默认文件夹名
def get_default_folder_name():
    return datetime.now().strftime('%Y%m%d%H%M')

# 提取 URL 文件名
def extract_filename_from_url(url):
    path = urlparse(url).path
    filename = os.path.basename(path)
    return filename if filename else str(uuid.uuid4())

# 单个下载逻辑
def download_file(url, folder_path):
    try:
        response = requests.get(url, timeout=10)
        response.raise_for_status()
        filename = extract_filename_from_url(url)
        save_path = os.path.join(folder_path, filename)
        with open(save_path, 'wb') as f:
            f.write(response.content)
        return True
    except:
        return False

# 下载并更新 UI 进度
def start_download_with_progress(urls, save_path, fail_log_path, progress_bar, status_label, start_button):
    total = len(urls)
    success = 0
    fail = 0

    def process_next(index):
        nonlocal success, fail

        if index >= total:
            status_label.config(text=f"✅ 下载完成,成功 {success} 个,失败 {fail} 个")
            start_button.config(state='normal')
            return

        url = urls[index]
        ok = download_file(url, save_path)
        if ok:
            success += 1
        else:
            fail += 1
            with open(fail_log_path, 'a', encoding='utf-8') as f:
                f.write(url + '\n')

        percent = int(((index + 1) / total) * 100)
        progress_bar['value'] = percent
        status_label.config(text=f"进度:{percent}%  | 成功:{success}  失败:{fail}")
        progress_bar.update()

        # 延迟调用下一项,避免 UI 卡死
        progress_bar.after(100, lambda: process_next(index + 1))

    process_next(0)

# 下载启动逻辑
def start_download(selected_file, folder_name_var, base_path_var, full_path_label_var,
                   progress_bar, status_label, start_button):
    if not selected_file:
        messagebox.showwarning("警告", "请先选择 Excel 文件")
        return

    folder_name = folder_name_var.get().strip() or get_default_folder_name()
    base_path = base_path_var.get().strip() or os.getcwd()
    save_path = os.path.join(base_path, folder_name)
    os.makedirs(save_path, exist_ok=True)
    full_path_label_var.set(f"保存路径:{save_path}")

    try:
        df = pd.read_excel(selected_file, usecols=[0])
        urls = df.iloc[:, 0].astype(str).str.strip()
        urls = urls[urls != '']  # 过滤空字符串
        urls = urls.tolist()

        if not urls:
            messagebox.showinfo("提示", "未检测到有效 URL")
            return

        # 清空失败记录
        failed_log_path = os.path.join(save_path, 'download_fail.log')
        with open(failed_log_path, 'w', encoding='utf-8') as f:
            pass

        progress_bar['maximum'] = 100
        progress_bar['value'] = 0
        progress_bar.pack(pady=10)
        status_label.pack()
        start_button.config(state='disabled')

        start_download_with_progress(urls, save_path, failed_log_path,
                                     progress_bar, status_label, start_button)

    except Exception as e:
        messagebox.showerror("错误", f"下载过程中发生错误:{e}")

# 文件选择
def choose_file(selected_file_var, file_label):
    file_path = filedialog.askopenfilename(filetypes=[("Excel 文件", "*.xlsx")])
    if file_path:
        selected_file_var.set(file_path)
        file_label.config(text=f"已选择文件:{os.path.basename(file_path)}")

# 保存路径选择
def select_directory(base_path_var, folder_name_var, full_path_label_var):
    selected = filedialog.askdirectory()
    if selected:
        base_path_var.set(selected)
        update_full_path_label(folder_name_var, base_path_var, full_path_label_var)

# 路径标签更新
def update_full_path_label(folder_name_var, base_path_var, full_path_label_var):
    folder_name = folder_name_var.get().strip() or get_default_folder_name()
    base_path = base_path_var.get().strip() or os.getcwd()
    full_path_label_var.set(f"保存路径:{os.path.join(base_path, folder_name)}")

# 主界面
def create_gui():
    root = Tk()
    root.title("URL 批量下载工具 作者:XMYX-0")
    root.geometry("620x460")

    selected_file_var = StringVar()
    folder_name_var = StringVar(value=get_default_folder_name())
    base_path_var = StringVar(value=os.getcwd())
    full_path_label_var = StringVar()

    # UI 元素
    Label(root, text="1. 选择包含 URL 的 Excel 文件(.xlsx)", font=("微软雅黑", 11)).pack(pady=10)
    file_label = Label(root, text="尚未选择文件", font=("微软雅黑", 10), fg="gray")
    file_label.pack()
    Button(root, text="选择 Excel 文件", font=("微软雅黑", 10),
           command=lambda: choose_file(selected_file_var, file_label)).pack(pady=5)

    Label(root, text="2. 设置保存目录", font=("微软雅黑", 11)).pack(pady=10)
    Label(root, text="保存子目录名称:", font=("微软雅黑", 10)).pack()
    folder_entry = Entry(root, textvariable=folder_name_var, font=("微软雅黑", 10), width=35)
    folder_entry.pack()

    path_frame = Frame(root)
    path_frame.pack(pady=10)
    Label(path_frame, text="保存路径:", font=("微软雅黑", 10)).grid(row=0, column=0, padx=5)
    path_entry = Entry(path_frame, textvariable=base_path_var, font=("微软雅黑", 10), width=35)
    path_entry.grid(row=0, column=1)
    Button(path_frame, text="浏览", command=lambda: select_directory(base_path_var, folder_name_var, full_path_label_var)).grid(row=0, column=2, padx=5)

    update_full_path_label(folder_name_var, base_path_var, full_path_label_var)
    Label(root, textvariable=full_path_label_var, font=("微软雅黑", 9), fg="gray").pack()

    progress_bar = ttk.Progressbar(root, length=400)
    status_label = Label(root, text="", font=("微软雅黑", 10))

    start_button = Button(root, text="✅ 开始下载", font=("微软雅黑", 12), bg="#4CAF50", fg="white",
                          command=lambda: start_download(
                              selected_file_var.get(),
                              folder_name_var,
                              base_path_var,
                              full_path_label_var,
                              progress_bar,
                              status_label,
                              start_button))
    start_button.pack(pady=20)

    folder_entry.bind("<KeyRelease>", lambda e: update_full_path_label(folder_name_var, base_path_var, full_path_label_var))
    path_entry.bind("<KeyRelease>", lambda e: update_full_path_label(folder_name_var, base_path_var, full_path_label_var))

    Label(root, text="注意:Excel 的第一行为标题,从第二行开始读取 URL", font=("微软雅黑", 9), fg="gray").pack(pady=10)

    root.mainloop()

if __name__ == "__main__":
    create_gui()

🧑‍💻 作者信息

  • 作者:XMYX-0
  • 简介:Python & DevOps 爱好者,热衷于实用自动化工具开发
  • 联系方式:

相关推荐
Ashlee_code2 分钟前
什么是Web3?金融解决方案
开发语言·金融·架构·eclipse·web3·区块链·php
weixin_307779138 分钟前
批量OCR的GitHub项目
python·github·ocr
Evand J15 分钟前
【MATLAB例程】AOA与TDOA混合定位例程,适用于三维环境、4个锚点的情况,附下载链接
开发语言·matlab
机器视觉知识推荐、就业指导16 分钟前
Qt 与Halcon联合开发八: 结合Qt与Halcon实现海康相机采图显示(附源码)
开发语言·数码相机·qt
Heartoxx44 分钟前
c语言-指针与一维数组
c语言·开发语言·算法
hqxstudying1 小时前
Java创建型模式---原型模式
java·开发语言·设计模式·代码规范
charlie1145141911 小时前
如何使用Qt创建一个浮在MainWindow上的滑动小Panel
开发语言·c++·qt·界面设计
孤狼warrior1 小时前
灰色预测模型
人工智能·python·算法·数学建模
神仙别闹1 小时前
基于Python实现LSTM对股票走势的预测
开发语言·python·lstm
机器学习之心2 小时前
小波增强型KAN网络 + SHAP可解释性分析(Pytorch实现)
人工智能·pytorch·python·kan网络