使用PySimpleGUI调用print()和sg.cprint()导致程序崩溃求助

问题根源 #

报错PyEval_RestoreThread: NULL tstate的核心原因是跨线程调用了PySimpleGUI的GUI相关操作。sg.cprint()本质是直接操作GUI组件，而PySimpleGUI的所有GUI接口都不是线程安全的。你之前用print()正常，是因为终端输出本身线程安全，不会触发Python线程状态管理的异常；但改用sg.cprint()后，若外部函数在非GUI主线程中执行，就会直接触发这个致命错误。

修复方案 #

1. 用队列实现线程安全的输出传递 #

PySimpleGUI官方推荐使用queue.Queue作为非主线程与GUI主线程的通信桥梁，避免直接跨线程调用GUI接口：

• 创建队列对象并传递给外部函数
• 外部函数将需要输出的内容存入队列，而非直接调用sg.cprint()
• GUI主线程在事件循环中定期检查队列，取出内容后统一用sg.cprint()输出

示例代码：

import PySimpleGUI as sg
import queue
import threading
from other_dir import external_function  # 导入其他目录的目标函数

# 创建线程安全的队列
output_queue = queue.Queue()

def run_external_task(queue):
    # 启动外部函数，传入队列用于传递输出
    external_function(queue)

# 构建GUI布局
layout = [
    [sg.Multiline(size=(80, 20), key='-OUTPUT_BOX-')],
    [sg.Button('执行函数'), sg.Button('退出')]
]

window = sg.Window('测试程序', layout, finalize=True)
# 将sg.cprint的输出定向到Multiline组件
sg.cprint_set_output_destination(window, '-OUTPUT_BOX-')

while True:
    event, values = window.read(timeout=100)  # 定期轮询队列
    if event == sg.WIN_CLOSED or event == '退出':
        break
    if event == '执行函数':
        # 启动子线程执行外部函数，避免阻塞GUI主线程
        threading.Thread(target=run_external_task, args=(output_queue,), daemon=True).start()
    
    # 处理队列中的输出内容
    while not output_queue.empty():
        content = output_queue.get()
        sg.cprint(content)

window.close()

对应其他目录的external_function.py：

def external_function(output_queue):
    # 替换原sg.cprint/print语句，改用队列传递内容
    output_queue.put("外部函数开始执行")
    # 你的业务逻辑代码...
    output_queue.put("外部函数执行完成")

2. 确保所有GUI操作在主线程执行 #

如果外部函数必须在主线程运行，那要避免函数执行时阻塞GUI循环——可以将函数逻辑拆分为非阻塞步骤，或者仍用子线程执行函数，仅通过队列传递结果到主线程处理输出。

3. 直接更新Multiline组件的替代方案 #

若不想用队列，也可以在主线程中直接调用Multiline组件的print方法更新内容，但同样要确保操作在GUI主线程中完成：

# 仅在GUI主线程中执行
window['-OUTPUT_BOX-'].print("需要输出的内容")

关键注意事项 #

• PySimpleGUI的所有GUI相关操作（包括sg.cprint()、组件更新）必须在创建窗口的主线程中执行
• 跨线程通信优先使用queue.Queue，这是Python官方推荐的线程安全通信方式
• 禁止在非GUI主线程中直接调用任何PySimpleGUI的API，否则必然触发线程状态异常

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