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

XMYX-02025-06-13 19:58

文章目录

  • [🧰 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

openpyxl 是 pandas.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 爱好者，热衷于实用自动化工具开发
  • 联系方式：
相关推荐
Edward-tan1 分钟前
CCPD 车牌数据集提取标注，并转为标准 YOLO 格式
python
晓131314 分钟前
JavaScript加强篇——第四章 日期对象与DOM节点(基础)
开发语言·前端·javascript
老胖闲聊16 分钟前
Python I/O 库【输入输出】全面详解
开发语言·python
倔强青铜三36 分钟前
苦练Python第18天：Python异常处理锦囊
人工智能·python·面试
倔强青铜三1 小时前
苦练Python第17天：你必须掌握的Python内置函数
人工智能·python·面试
迷路爸爸1801 小时前
让 VSCode 调试器像 PyCharm 一样显示 Tensor Shape、变量形状、变量长度、维度信息
ide·vscode·python·pycharm·debug·调试
她说人狗殊途1 小时前
java.net.InetAddress
java·开发语言
天使day2 小时前
Cursor的使用
java·开发语言·ai
咸鱼鲸2 小时前
【PyTorch】PyTorch中的数据预处理操作
人工智能·pytorch·python
Dxy12393102162 小时前
Python ExcelWriter详解：从基础到高级的完整指南
开发语言·python
热门推荐
01全球最强模型Grok4，国内已可免费使用！（附教程）02KGG转MP3工具|非KGM文件|解密音频03Coze扣子平台完整体验和实践（附国内和国际版对比）04身弱武修法：玄之又玄，奇妙之门05集群聊天服务器---MySQL数据库的建立06扣子（coze）实战|我用扣子搭建了一个自动分析小红薯笔记内容的AI应用|详细步骤拆解07使用Ruby接入实时行情API教程08【无标题】09DeepSeek各版本说明与优缺点分析10浅谈几种js设计模式