解决PySimpleGUI read方法阻塞主线程的问题

你遇到的核心问题是PySimpleGUI默认的read()方法会阻塞主线程，导致后续后台逻辑无法执行。以下是具体的解决方法：

解决方案思路 #

将阻塞式的window.read()替换为带超时的非阻塞事件循环，让主线程既能响应GUI事件，又能同步执行后台数据处理逻辑；同时优化线程间状态传递的安全性。

修改后的代码示例 #

1. 优化main.py

from src.components import gui, logger
from pynput import keyboard
import threading
import PySimpleGUI as sg


def on_press(key):
    try:
        start.set()  # 用Event替代全局变量，线程操作更安全
        print('alphanumeric key {0} pressed'.format(key.char))
    except AttributeError:
        print('special key {0} pressed'.format(key))


if __name__ == "__main__":
    start = threading.Event()  # 线程安全的状态标记

    # 启动键盘监听线程
    listener = keyboard.Listener(on_press=on_press)
    listener.start()

    # 初始化GUI窗口
    image_window = gui.create_image_window()
    gui.welcome_window(image_window)

    # 非阻塞事件循环，替代原阻塞式read()
    while True:
        # 每10ms检查一次GUI事件，不阻塞主线程
        event, values = image_window.read(timeout=10)
        
        # 处理窗口关闭事件，确保程序正常退出
        if event == sg.WINDOW_CLOSED:
            break
        
        # 执行后台逻辑
        if not start.is_set():
            print("Something")
            # 按需更新GUI（示例：每100次循环更新一次处理状态）
            # if some_counter % 100 == 0:
            #     image_window['-IMAGE-'].update(filename="./src/resources/processing.png")
            #     image_window.Refresh()
        else:
            # 触发键盘事件后，更新GUI状态
            image_window['-IMAGE-'].update(filename="./src/resources/started_status.png")
            image_window.Refresh()
            # 若无需继续运行，可在此处退出循环
            # break

    # 清理资源
    image_window.close()
    listener.stop()

2. 优化gui.py（移除冗余代码）

import PySimpleGUI as sg
import base64

icon = base64.b64encode(open('./src/resources/paper-clip.png', 'rb').read())


def create_text_window():
    sg.theme('DarkBlack1')
    layout = [[sg.Text("Example", key="-TEXT-")]]
    return sg.Window(title="Example", layout=layout, resizable=False, size=(500, 300), keep_on_top=True,
                     icon=icon, titlebar_icon=icon, margins=(0,0), element_padding=(0,0), finalize=True)


def create_image_window():
    image = sg.Image(size=(500, 300), key="-IMAGE-")
    layout = [[image]]
    return sg.Window(title="Example", layout=layout, resizable=False, size=(500, 300), keep_on_top=True,
                     icon=icon, titlebar_icon=icon,margins=(0,0), element_padding=(0,0), finalize=True)


def welcome_window(window):
    # 移除冗余的sg.Image实例，直接更新窗口内已存在的元素
    window['-IMAGE-'].update(filename="./src/resources/example.png")
    window.Refresh()

关键说明 #

• 非阻塞事件循环：read(timeout=10)让GUI每隔10毫秒返回一次事件，主线程不会被卡住，能同步执行后台逻辑。
• 线程安全：用threading.Event替代全局变量start，避免多线程环境下的状态不一致问题。
• GUI更新时机：在后台逻辑中加入条件判断（如计数器、状态变化），按需调用update()和Refresh()更新界面，避免频繁刷新影响性能。

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