如何使用PyQt5 WebEngine编写Python脚本实现文件自动下载？

阿华AIGC实验室

2026-5-26

使用PyQt5 WebEngine实现文件自动下载的解决方案

嘿，我来帮你搞定PyQt5 WebEngine的自动下载问题！你已经搭好了基础代码框架，接下来咱们把它完善，实现通用下载功能，同时针对你指定的特定链接（比如http://test.com/somefile.avi）做自动触发下载的逻辑。

核心思路

PyQt5的QWebEngineProfile提供了downloadRequested信号——所有来自WebEngine的下载请求都会触发这个信号。我们只需要监听这个信号，在回调函数里判断请求的URL是否是我们想要自动下载的目标，然后自动处理下载流程即可。

完整代码实现

我把你的代码补全并优化，添加了自动下载的核心逻辑：

import os
import sys
from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QFileDialog
from PyQt5.QtCore import QUrl
from PyQt5.QtWebEngineWidgets import QWebEngineView, QWebEngineProfile, QWebEngineDownloadItem

class WebPage(QWebEngineView):
    def __init__(self):
        super().__init__()
        # 加载目标网页
        self.load(QUrl("http://test.com"))
        
        # 获取全局WebEngine配置，监听所有下载请求
        self.profile = QWebEngineProfile.defaultProfile()
        self.profile.downloadRequested.connect(self.handle_download)
        
        # 定义需要自动下载的目标链接（可以是精确匹配，也可以是包含特定关键词）
        self.target_download_url = "http://test.com/somefile.avi"

    def handle_download(self, download_item: QWebEngineDownloadItem):
        # 获取当前下载请求的URL字符串
        current_download_url = download_item.url().toString()
        print(f"捕获到下载请求: {current_download_url}")
        
        # 判断是否是我们要自动下载的目标链接
        if current_download_url == self.target_download_url:
            print("匹配到目标链接，启动自动下载...")
            # 设置保存路径：当前目录 + 建议的文件名
            save_dir = os.getcwd()
            save_path = os.path.join(save_dir, download_item.suggestedFileName())
            
            # 确保保存目录存在（如果路径包含子目录的话）
            os.makedirs(os.path.dirname(save_path), exist_ok=True)
            
            # 设置下载路径并确认下载
            download_item.setPath(save_path)
            download_item.accept()
            
            # 监听下载完成信号，做后续提示
            download_item.finished.connect(
                lambda: print(f"文件已成功保存到: {save_path}")
            )
        else:
            # 非目标链接：弹出对话框让用户选择是否保存（可根据需求修改逻辑）
            save_path, _ = QFileDialog.getSaveFileName(
                self, "选择保存路径", download_item.suggestedFileName()
            )
            if save_path:
                download_item.setPath(save_path)
                download_item.accept()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    # 创建主窗口和布局
    main_window = QWidget()
    layout = QVBoxLayout(main_window)
    # 添加WebView到布局
    web_view = WebPage()
    layout.addWidget(web_view)
    # 显示窗口
    main_window.show()
    sys.exit(app.exec_())

关键代码解释

监听下载请求：通过QWebEngineProfile.defaultProfile()获取全局配置，这样所有WebView实例的下载请求都会被捕获。
判断目标链接：在handle_download回调里，把下载项的URL转换成字符串，和我们预设的目标链接对比。如果是动态生成的链接（比如带参数），可以改用包含判断，比如"somefile.avi" in current_download_url。
自动下载流程：匹配成功后，设置保存路径（确保目录存在），调用accept()启动下载，还可以监听finished信号做下载完成的提示。
非目标链接处理：对于其他下载请求，我们弹出保存对话框让用户手动选择，你也可以根据需求改成自动忽略或者其他逻辑。