Python Tkinter Canvas图片更新失效问题（已定位原因）

核心问题分析 #

你的代码存在两个关键问题：

1. PhotoImage被垃圾回收：函数内的photo_img是局部变量，函数执行完毕后会被Python自动回收，Tkinter无法再引用该图片对象，直接导致Canvas显示空白。
2. 变量作用域（可选场景）：如果canvas和image_container是局部变量（比如定义在某个函数内部），事件回调函数draw_rectangle无法直接访问它们；若为全局变量则该问题不存在，但垃圾回收是导致空白的直接原因。

解决方案 #

方案1：保留PhotoImage的引用 #

将photo_img绑定到Canvas对象的属性上，避免被垃圾回收机制清理：

def draw_rectangle(event):
    # 假设x1、y1、x2、y2是你已获取的鼠标坐标
    cv2img = cv2.rectangle(data, pt1=(x1, y1), pt2=(x2, y2), color=(255, 255, 255), thickness=5)
    img = Image.fromarray(cv2img)
    photo_img = ImageTk.PhotoImage(img)
    # 将图片对象绑定到canvas属性，保留引用
    canvas.photo_img = photo_img
    canvas.itemconfig(image_container, image=photo_img)

方案2：声明全局变量（针对局部变量场景） #

如果canvas和image_container是在其他函数内定义的局部变量，需在回调函数中声明为全局变量：

def draw_rectangle(event):
    global canvas, image_container
    cv2img = cv2.rectangle(data, pt1=(x1, y1), pt2=(x2, y2), color=(255, 255, 255), thickness=5)
    img = Image.fromarray(cv2img)
    photo_img = ImageTk.PhotoImage(img)
    canvas.photo_img = photo_img
    canvas.itemconfig(image_container, image=photo_img)

方案3：类封装（规范的项目写法） #

大型项目建议用类管理组件和变量，避免全局变量混乱：

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

class ImageEditor:
    def __init__(self, root):
        self.root = root
        # 创建Canvas组件
        self.canvas = tk.Canvas(root, width=640, height=480)
        self.canvas.place(x=50, y=50)
        # 绑定鼠标事件
        self.canvas.bind("<B1-Motion>", self.draw_rectangle)
        self.canvas.bind("<Button-1>", self.record_start_point)
        # 加载初始图片
        self.data = cv2.cvtColor(cv2.imread("test_image.png"), cv2.COLOR_BGR2RGB)
        test_img = ImageTk.PhotoImage(Image.fromarray(self.data))
        self.image_container = self.canvas.create_image(0, 0, anchor="nw", image=test_img)
        self.canvas.photo_img = test_img  # 保留初始图片引用
        # 记录鼠标起始点
        self.start_x = 0
        self.start_y = 0

    def record_start_point(self, event):
        self.start_x = event.x
        self.start_y = event.y

    def draw_rectangle(self, event):
        # 复制原始图像，避免反复修改原图
        temp_data = self.data.copy()
        cv2img = cv2.rectangle(temp_data, pt1=(self.start_x, self.start_y), pt2=(event.x, event.y), color=(255, 255, 255), thickness=5)
        img = Image.fromarray(cv2img)
        photo_img = ImageTk.PhotoImage(img)
        self.canvas.photo_img = photo_img
        self.canvas.itemconfig(self.image_container, image=photo_img)

if __name__ == "__main__":
    root = tk.Tk()
    app = ImageEditor(root)
    root.mainloop()

额外注意事项 #

• OpenCV读取的图片是BGR格式，PIL使用RGB格式，必须用cv2.cvtColor(data, cv2.COLOR_BGR2RGB)转换，否则会出现颜色异常。
• 每次绘制矩形时建议复制原始图像数据，避免多次绘制导致原图被破坏。

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