PyQt5多线程语音识别场景下QTextBrowser文本无法动态更新

问题根因 #

• PyQt的所有UI控件更新操作只能在主线程执行，你在自定义的MainThread子线程中直接调用self.textBrowser.setText()属于跨线程操作UI，会导致更新失效甚至程序崩溃
• 你的MainThread类没有和主线程的UI实例绑定，找不到对应的textBrowser控件，调用方法自然失效
• MainFunctions里的死循环加processEvents()的写法不规范，容易导致线程调度异常

具体修改步骤 #

1. 给子线程类添加自定义信号 #

在MainThread类里定义自定义的pyqtSignal，用来把需要更新的文本传递给主线程：

class MainThread(QThread):
    # 自定义信号，参数为需要展示的文本
    update_text = pyqtSignal(str)
    def __init__(self):
        super(MainThread, self).__init__()

2. 替换子线程中的setText操作为信号发送 #

把run方法里所有self.textBrowser.setText()的代码，替换成信号发射：

def run(self):
    r = sr.Recognizer()
    with sr.Microphone() as source:
        # 发送信号通知主线程更新文本
        self.update_text.emit("Listening...")
        r.pause_threshold = 1
        r.energy_threshold = 4000
        audio = r.listen(source)
    try:
        self.update_text.emit("Recognizing...")
        query = r.recognize_google(audio,language="en-in")
        self.update_text.emit(f"User : {query}")
    except:
        self.update_text.emit("Recognition failed, please try again")
        return ""
    query = str(query)
    return query.lower()

3. 主线程绑定信号接收槽函数 #

在GUI_Start的__init__方法里，绑定子线程的信号和UI更新的槽函数，同时把子线程的实例放到类内部，不要用全局变量：

class GUI_Start(QMainWindow):
    def __init__(self):
        super().__init__()
        self.gui = Example()
        self.gui.setupUi(self)
        # 把线程实例放到类内部管理
        self.work_thread = MainThread()
        # 绑定信号槽：子线程发信号，主线程更新textBrowser
        self.work_thread.update_text.connect(self.update_text_browser)
        self.gui.Start_Button.clicked.connect(self.Start_Task)
    
    # 定义槽函数，专门用来更新textBrowser
    def update_text_browser(self, text):
        self.gui.textBrowser.setText(text)

4. 修复线程启动的逻辑 #

去掉MainFunctions里的死循环写法，直接启动线程即可，不要重复调用start()：

def Start_Task(self):
    if self.gui.Start_Button.isChecked():
        self.gui.Start_Button.setText("Stop")
        # 注意：你原代码里的Gif_1控件在UI定义中不存在，需要先在UI类的setupUi方法里补加该QLabel控件才能正常使用GIF功能
        # self.gui.label = QtGui.QMovie("你的GIF文件路径")
        # self.gui.Gif_1.setMovie(self.gui.label)
        # self.gui.label.start()
        # 仅在线程未运行时启动，避免重复调用报错
        if not self.work_thread.isRunning():
            self.work_thread.start()
    else:
        self.gui.Start_Button.setText("Start")
        # self.gui.label.stop()
        if self.work_thread.isRunning():
            self.work_thread.terminate()

最后删除原代码中全局的StartExecution变量和MainFunctions方法即可 #

其他注意事项 #

• 同一个QThread实例终止后需要重新初始化才能再次启动，建议每次启动前先判断线程运行状态
• 尽量不要用terminate()强制终止线程，可添加自定义终止标志位实现线程的安全退出

内容的提问来源于stack exchange，提问作者Prachi Kakkad