如何将Pygame棋盘游戏嵌入Tkinter窗口（实现单窗口显示）

核心思路是放弃创建独立的Pygame窗口，改用Pygame Surface绘制游戏内容，再将Surface转换为Tkinter可识别的图像格式，嵌入到Tkinter窗口的Canvas组件中，同时用Tkinter的事件循环替代Pygame主循环，彻底避免双窗口问题。

完整代码示例 #

import tkinter as tk
import pygame
from PIL import Image, ImageTk

# 初始化配置
WIDTH, HEIGHT = 600, 600
pygame.init()

# 创建Tkinter主窗口
root = tk.Tk()
root.title("棋盘游戏")

# 创建Pygame绘制用的Surface（不创建独立窗口）
game_surface = pygame.Surface((WIDTH, HEIGHT))

# 定义重置棋盘函数
def reset_board():
    # 这里替换为你的棋盘重置逻辑
    print("棋盘已重置")

# 添加Tkinter控件：重置按钮+游戏显示画布
reset_btn = tk.Button(root, text="重置棋盘", command=reset_board, font=("Arial", 14))
reset_btn.pack(pady=10)

canvas = tk.Canvas(root, width=WIDTH, height=HEIGHT, bg="white")
canvas.pack()

# 游戏更新循环（替代Pygame的while循环）
def update_game():
    # 处理Pygame事件
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            root.quit()
        # 处理游戏交互事件（比如棋盘点击）
        if event.type == pygame.MOUSEBUTTONDOWN:
            # 这里替换为你的棋盘点击逻辑
            mouse_pos = pygame.mouse.get_pos()
            print(f"点击位置：{mouse_pos}")

    # 绘制游戏内容到Surface
    game_surface.fill((255, 255, 255))
    # 这里替换为你的棋盘绘制逻辑（示例：画棋盘边框和格子）
    pygame.draw.rect(game_surface, (0, 0, 0), (50, 50, 500, 500), 2)
    for i in range(1, 10):
        pygame.draw.line(game_surface, (0, 0, 0), (50 + i*50, 50), (50 + i*50, 550), 1)
        pygame.draw.line(game_surface, (0, 0, 0), (50, 50 + i*50), (550, 50 + i*50), 1)

    # 将Pygame Surface转换为Tkinter可显示的图像
    img_data = pygame.image.tostring(game_surface, 'RGB')
    pil_img = Image.frombytes('RGB', (WIDTH, HEIGHT), img_data)
    tk_img = ImageTk.PhotoImage(image=pil_img)

    # 更新画布内容（必须保留tk_img引用，防止被垃圾回收）
    canvas.create_image(0, 0, anchor=tk.NW, image=tk_img)
    canvas.image = tk_img

    # 递归调用，维持60帧/秒的更新频率
    root.after(16, update_game)

# 启动游戏更新循环和Tkinter主循环
update_game()
root.mainloop()

关键注意事项 #

1. 避免创建Pygame独立窗口：不要调用pygame.display.set_mode()，所有绘制操作都在pygame.Surface上完成。
2. 图像转换依赖PIL库：需要先安装pillow（执行pip install pillow），用于将Pygame Surface转换为Tkinter支持的PhotoImage。
3. 保留图像引用：必须将tk_img赋值给canvas.image，否则Python垃圾回收机制会自动清理图像，导致画布显示空白。
4. 用Tkinter的after替代Pygame循环：root.after(16, update_game)相当于每16毫秒（约60帧）执行一次更新，既保证游戏流畅，又不会阻塞Tkinter的事件响应。

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