嵌入Tkinter窗口的Pygame事件在树莓派上失效问题排查

1. 核心问题点 #

• Pygame初始化顺序错误：代码先创建显示窗口再调用pygame.init()，完全颠倒了正确流程，导致SDL模块初始化不完整。
• 阻塞Tkinter主循环：在App的__init__中直接写死循环，导致Tkinter的主事件循环（mainloop()）无法启动，Linux（树莓派）的事件模型对此更为敏感。
• 树莓派SDL适配问题：默认的SDL驱动配置可能无法适配树莓派的X11/Wayland显示环境。

修复后的代码 #

from distutils.command.config import config
import logging
from logging.handlers import RotatingFileHandler
import os
from logging import root
import tkinter
import tkinter as tk
import tkinter.messagebox
import customtkinter
from threading import Thread
from tkinter import Label
from random import *
from itertools import count, cycle
from tkinter import *
from tkinter import ttk, Scrollbar
import platform
import pygame

class App(customtkinter.CTk):
    def __init__(self):
        super().__init__()
        tabview = customtkinter.CTkTabview(self, height=500, width=500)
        tabview.place(x=-5, y=-50, anchor=tkinter.NW)
        tabview.add("tab_main")
        tabview.set("tab_main")

        self.pygame_running = True
        pygame_width = 400
        pygame_height = 400
        self.embed_pygame = tk.Frame(tabview.tab("tab_main"), width=pygame_width, height=pygame_height)
        self.embed_pygame.place(x=10, y=10)
        self.update()

        # 配置SDL环境变量
        os.environ['SDL_WINDOWID'] = str(self.embed_pygame.winfo_id())
        system = platform.system()
        if system == "Windows":
            os.environ['SDL_VIDEODRIVER'] = 'windib'
        elif system == "Linux":
            # 树莓派强制使用X11驱动，适配多数桌面环境
            os.environ['SDL_VIDEODRIVER'] = 'x11'
            # Wayland环境下可尝试添加：os.environ['SDL_DISPLAY'] = ':0'

        # 先初始化Pygame核心模块
        pygame.init()
        self.display_surface = pygame.display.set_mode((pygame_width, pygame_height))
        self.display_surface.fill((0, 50, 0))
        self.background_surface = pygame.Surface((pygame_width, pygame_height))
        self.clock = pygame.time.Clock()

        # 独立线程运行Pygame循环，避免阻塞Tkinter主循环
        self.pygame_thread = Thread(target=self.pygame_loop)
        self.pygame_thread.daemon = True
        self.pygame_thread.start()

    def pygame_loop(self):
        while self.pygame_running:
            # 处理Pygame事件
            for event in pygame.event.get():
                if event.type == pygame.QUIT:
                    self.pygame_running = False
                    self.quit()
                elif event.type == pygame.MOUSEBUTTONDOWN:
                    print('Clicked on image')

            # 更新画面
            self.display_surface.blit(self.background_surface, (0, 0))
            pygame.display.update()
            self.clock.tick(60)

    def destroy(self):
        self.pygame_running = False
        super().destroy()

if __name__ == "__main__":
    try:
        app = App()
        app.mainloop()
    except Exception as e:
        logging.critical(f"An exception occurred: {e}")
        print(f"An exception occurred: {e}")

额外注意事项 #

• 安装树莓派依赖：sudo apt-get install python3-pygame python3-tk python3-customtkinter
• 若使用Wayland桌面，建议切换到X11（系统设置-显示配置中调整），或添加SDL_DISPLAY环境变量
• 避免用root用户运行程序，防止X11权限冲突

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