PC模拟树莓派OLED显示触发tkinter image不存在错误求助

这个问题我碰到过好几次，核心原因有两个：多个Tk主实例冲突，以及PIL图像转Tkinter图像时的引用回收问题，咱们一步步来解决：

问题根源分析 #

1. 多个Tk实例的冲突：你的Wdisp类在初始化时自己创建了self.master = Tk()，而测试代码里又创建了master = Tk()。Tkinter的图像资源是和主Tk实例绑定的，多个主实例会导致图像命名混乱，出现pyimageX doesn't exist这类错误。
2. 图像引用被垃圾回收：Wdisp.display()里用了BitmapImage，而且新创建的图像对象没有被正确保留引用，Python垃圾回收器会把它销毁，导致Label找不到图像。

解决方案 #

1. 修改Wdisp类：复用已有Tk实例，修复图像处理逻辑 #

把Wdisp改成接受一个父窗口参数，不再自己创建Tk实例，同时用PhotoImage替代BitmapImage，并确保图像引用被保留：

# Windows substitute OLED display class
# displays a label image for testing
from tkinter import *
from PIL import Image, ImageTk

class Wdisp(object):
    width = 128
    height = 64
    _image = None
    def __init__(self, parent):  # 接受父窗口参数
        self.master = parent  # 复用传入的主窗口/顶层窗口
        self._image = Image.new('1', (self.width, self.height))
        # 转换PIL图像为Tkinter PhotoImage，注意保持引用
        self.photo = ImageTk.PhotoImage(self._image)
        self.L = Label(self.master, image=self.photo)
        self.L.pack(expand=YES, fill=BOTH)

    def begin(self):
        pass

    def image(self, newimage):
        self._image = newimage

    def display(self):
        # 将单色PIL图像转为适合Tkinter的格式，保持引用
        self.photo = ImageTk.PhotoImage(self._image)
        self.L.config(image=self.photo)
        # 额外保留引用防止被回收（可选但保险）
        self.L.image = self.photo

2. 修改OLEDDisplay类：支持传递父窗口给Wdisp #

调整__init__方法，让它可以接收一个parent参数，传给Windows下的Wdisp：

# OLED display object
import os
Win = False
if os.name == 'nt':
    Win=True
    from WindowsOLED import Wdisp
else:
    import Adafruit_GPIO.SPI as SPI
    import Adafruit_SSD1306
    from PIL import Image
    from PIL import ImageDraw
    from PIL import ImageFont

class OLEDDisplay(object):
    def __init__(self, parent=None):  # 添加parent参数
        # Raspberry Pi pin configuration:
        RST = 24
        if Win:
            assert parent is not None, "Windows下必须传入Tk父窗口实例"
            self.disp = Wdisp(parent)  # 传递父窗口
        else:
            self.disp = Adafruit_SSD1306.SSD1306_128_64(rst=RST)
        # Initialize library.
        self.disp.begin()
        # Create blank image for drawing.
        self.width = 128
        self.height = 64
        self._image = Image.new('1', (self.width, self.height))
        self.draw = ImageDraw.Draw(self._image)
        # Load default font.
        self.font = ImageFont.load_default()
        self.clear()

    # 其他方法保持不变
    def __del__(self):
        self.clear()
    def __repr__(self):
        return 'OLED display object for SSD1306 I2C'
    def clear(self):
        # Clear display
        self.disp.clear()
        self.disp.display()
    def write(self, text):
        self.draw.text((0, 2), text, font=self.font, fill=255)
        self._show()
    def progressbar(self, percent):
        shape_width = self.width * (percent/100)
        padding =2
        top = padding
        bottom = (self.height/2) - padding
        x = padding
        self.draw.rectangle((x, top, self.width-padding, bottom), outline=255, fill=0)
        self.draw.rectangle((x, top, x+shape_width, bottom), outline=255, fill=255)
        self._show()
    def loadimage(self, imagefile):
        self._image = Image.open(imagefile).resize((self.width, self.height), Image.ANTIALIAS).convert('1')
        self._show()
    def _show(self):
        self.disp.image(self._image)
        self.disp.display()

3. 修改测试应用代码：传递主窗口给OLEDDisplay #

创建OLEDDisplay实例时，把master传递进去，同时修复输入框获取内容的小错误：

# 测试应用代码
from tkinter import *
from OLEDDisplay import OLEDDisplay

def updateOLED():
    text = E.get()  # 原代码漏了括号，这里修正为调用方法获取内容
    print(text)
    OD.clear()  # 先清除之前的内容，避免文字叠加
    OD.write(text)

master = Tk()
master.title("OLED模拟测试")
OD = OLEDDisplay(parent=master)  # 传递主窗口
E = Entry(master)
B = Button(master, text="update OLED", command=updateOLED)
E.pack(pady=5)
B.pack(pady=5)

master.mainloop()

额外注意点 #

• 在Wdisp.display()里，self.L.image = self.photo是关键：它确保PhotoImage对象被Label引用，不会被Python垃圾回收器销毁，这是Tkinter图像使用的常见坑。
• Windows下必须传递父窗口实例，代码里加了assert来强制提醒，避免忘记传参导致错误。

这样修改后，多个Tk实例的冲突就解决了，图像引用也能正确保留，你再运行测试代码应该就不会出现pyimage4 doesn't exist的错误了。

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