Tkinter中如何更新Canvas画布及图像实现棋盘重渲染

你的代码无法触发棋盘重渲染是几个典型的Tkinter使用错误导致的：

• window.mainloop()是Tkinter的阻塞式事件循环，你把它写在了render()函数内部，首次调用render()后程序会一直卡在事件循环中，后续修改棋盘状态、再次调用render()的代码完全没有执行机会。
• 每次调用render()都会新建一个tk.Tk()根窗口，Tkinter应用全局只能存在一个根窗口实例，重复创建会触发组件状态异常，新的渲染内容无法正常加载显示。
• 重渲染前没有清空Canvas上已绘制的旧棋子元素，就算执行了新的绘制逻辑，新棋子也会和旧内容重叠，无法观察到位置更新效果。
• 图片资源定义在render()函数内部作为局部变量，每次重渲染都会重复加载图片浪费性能，且如果引用没有被持久持有，会被Python垃圾回收机制回收，导致图片显示空白。

• 将根窗口、Canvas、图片资源的初始化逻辑移到渲染函数外，程序启动时仅初始化一次。
• 把mainloop()移到程序入口的最末尾，不要放在渲染逻辑内部。
• 每次执行重渲染前，先调用canvas.delete("all")清空画布上的所有旧内容，再按顺序绘制棋盘底图和棋子。
• 单独封装棋盘刷新函数，棋盘状态更新后仅调用刷新函数即可，不需要重复创建窗口和组件。

import tkinter as tk
from PIL import Image, ImageTk

# 全局仅初始化一次窗口和组件
window = tk.Tk()
window.geometry("1920x1080")
window.title("Chess 2")

frame = tk.Frame(window)
frame.pack()

canvas = tk.Canvas(frame, width=800, height=800)
canvas.pack()

# 预加载所有图片资源，持久持有引用避免被垃圾回收
boardImg = ImageTk.PhotoImage(file=r"successful projects\imgs\board.png")
whitePawnImg = ImageTk.PhotoImage(file=r"successful projects\imgs\whitePawn.png")
blackPawnImg = ImageTk.PhotoImage(file=r"successful projects\imgs\blackPawn.png")
# 其余棋子图片按相同格式预加载即可

# 初始棋盘状态
board = [
    [' ', ' '],
    [' ', 'p']
]

def refresh_board():
    # 清空画布所有旧内容
    canvas.delete("all")
    # 绘制棋盘底图
    canvas.create_image(400, 400, image=boardImg)
    # 遍历棋盘绘制当前所有棋子
    for y in range(len(board)):
        for x in range(len(board[y])):
            match board[y][x]:
                case "p":
                    canvas.create_image(50 + (x*100), 50 + (y*100), image=blackPawnImg)
                # 其余棋子的匹配判断逻辑按原有规则补全
                case _:
                    pass

# 首次加载渲染棋盘
refresh_board()

# 测试逻辑：3秒后移动黑兵位置，触发重渲染
def test_pawn_move():
    board[1][1] = ' '
    board[0][1] = 'p'
    refresh_board()
window.after(3000, test_pawn_move)

# 启动事件循环，放在程序最后
window.mainloop()

所有棋子图片只需要在程序启动时预加载一次即可，不需要每次刷新都重新读取文件，能大幅降低渲染开销，避免不必要的IO占用。

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