如何在PyQt5中为PDF转语音功能实现多线程进度显示

要实现后台转换+实时更新UI，核心是把耗时的PDF转语音逻辑放到独立线程中，通过Qt的信号槽机制传递进度数据到主线程更新UI（从你的控件命名判断，你应该用的是PyQt/PySide框架）。以下是具体实现方案：

步骤1：定义线程类，封装转换逻辑 #

创建继承自QThread的线程类，将转换核心逻辑移到run()方法，同时定义信号用于传递进度和当前页码：

from PyQt5.QtCore import QThread, pyqtSignal
# 若使用PySide2/PySide6，替换为Signal替代pyqtSignal

class ConvertThread(QThread):
    # 定义信号：参数分别为当前进度值、当前页码
    progress_updated = pyqtSignal(int)
    page_updated = pyqtSignal(int)

    def __init__(self, pdfreader, start_page, end_page, save_path):
        super().__init__()
        self.pdfreader = pdfreader
        self.start_page = start_page
        self.end_page = end_page
        self.save_path = save_path
        self.is_running = True  # 用于控制线程中途停止

    def run(self):
        total_pages = self.end_page - self.start_page + 1
        speaker = pyttsx3.init()
        speaker.setProperty("rate", 140)
        
        for i in range(self.start_page - 1, self.end_page):
            if not self.is_running:
                break  # 响应中途停止指令
            
            current_page_num = i + 1
            # 提取页面文本并保存为MP3
            page = self.pdfreader.getPage(i)
            text = page.extractText()
            speaker.save_to_file(text, f'{self.save_path}\\page {current_page_num}.mp3')
            speaker.runAndWait()
            
            # 计算进度并发送信号到主线程
            progress = int(((current_page_num - self.start_page + 1) / total_pages) * 100)
            self.progress_updated.emit(progress)
            self.page_updated.emit(current_page_num)
        
        speaker.stop()
        self.pdfreader.close()  # 关闭PDF文件，对应你代码中的self.book

    def stop(self):
        self.is_running = False

步骤2：修改按钮点击事件，启动线程 #

原convert_clicked函数不再直接执行转换，改为初始化线程、连接信号并启动：

def convert_clicked(self):
    # 获取起止页码
    self.start = int(self.lineEdit_5.text())
    self.end = int(self.lineEdit_8.text())
    
    # 初始化进度条范围
    self.progressBar.setRange(0, 100)
    self.progressBar.setValue(0)
    
    # 创建线程实例
    self.convert_thread = ConvertThread(
        pdfreader=self.pdfreader,
        start_page=self.start,
        end_page=self.end,
        save_path=self.save_path
    )
    
    # 连接信号到UI更新函数
    self.convert_thread.progress_updated.connect(self.update_progress_bar)
    self.convert_thread.page_updated.connect(self.update_current_page)
    # 线程结束后可添加完成提示
    self.convert_thread.finished.connect(lambda: self.label_status.setText("转换完成"))
    
    # 启动线程
    self.convert_thread.start()

步骤3：实现UI更新的槽函数 #

这两个函数负责接收线程信号，更新进度条和页码显示：

def update_progress_bar(self, progress):
    self.progressBar.setValue(progress)

def update_current_page(self, page_num):
    # 假设你有一个QLabel用于显示当前页码，比如self.label_current_page
    self.label_current_page.setText(f"当前转换：第{page_num}页")

额外说明 #

• 所有UI操作必须在主线程执行，Qt的信号槽会自动完成线程间的消息分发，无需手动切换线程。
• 若需要支持中途取消转换，可添加“取消”按钮，点击时调用self.convert_thread.stop()即可。
• 注意路径转义问题，建议用\\或原始字符串r''避免路径解析错误。

内容的提问来源于stack exchange，提问作者Chandler Bong