PyQt5中使用QThread处理Python列表的搜索异常排查

我正在开发一个Python搜索工具，将包含大量字符串的items列表按每10万条为一组拆分为多个子列表：

split_lists = [items[x:x+100000] for x in range(0, len(items), 100000)]

随后将每个子列表传入自定义QThread子类ItemSearcher，以并发方式搜索关键词（示例为"Hello"）：

keyword = "Hello"

for i in range(len(split_lists)):
  item_searcher = ItemSearcher(split_lists[i], keyword)
  # Start the thread
  item_searcher.start()

ItemSearcher类实现如下：

class ItemSearcher(QtCore.QThread):

    def __init__(self, itemList, searchKeyword):
        """
        Constructor
        """
        super().__init__()

        # Initialize fields
        self.item_list = itemList
        self.search_keyword = searchKeyword

    def run(self):
        for item in self.item_list:
            if self.search_keyword in item:
                # Item found
                print(item)

但脚本执行后立即结束且无任何输出，线程未正常工作。

• 主线程提前终止，子线程被强制退出
  Qt默认将QThread设为守护线程，主线程结束时所有子线程会被直接终止，来不及执行搜索逻辑。解决方法有两种：

  1. 保存所有线程实例，调用wait()等待全部完成：

     keyword = "Hello"
     threads = []
     
     for sub_list in split_lists:
         item_searcher = ItemSearcher(sub_list, keyword)
         threads.append(item_searcher)
         item_searcher.start()
     
     # 等待所有线程执行完毕
     for thread in threads:
         thread.wait()
     

  2. 将线程设置为非守护线程（不推荐作为首选，可能导致程序无法正常退出）：

     item_searcher = ItemSearcher(sub_list, keyword)
     item_searcher.setDaemon(False)
     item_searcher.start()
     

• 验证数据源与匹配逻辑
  确认items列表不为空，且确实包含带有"Hello"的字符串。可以临时修改run()方法里的逻辑，直接打印所有item，验证线程是否在执行：

  def run(self):
      for item in self.item_list:
          print(item, flush=True)
  

• GUI程序需启动事件循环
  如果是Qt GUI程序，主线程必须启动事件循环才能维持线程运行。在程序入口添加：

  import sys
  from PyQt5 import QtWidgets
  
  if __name__ == "__main__":
      app = QtWidgets.QApplication(sys.argv)
      # 执行你的拆分、线程启动逻辑
      sys.exit(app.exec_())
  

• 解决打印缓冲问题
  控制台输出可能存在缓冲，导致内容无法及时显示。修改print语句强制刷新：

  print(item, flush=True)
  

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