使用Tkinter Canvas遇TclError：图片pyimage不存在求解决

在使用Tkinter Canvas时遇到错误：程序能成功加载图片并打印1，但执行canvas.create_image()时触发TclError，提示指定图片不存在。已尝试更换图片、使用绝对路径等方法，问题仍未解决。

相关代码 #

entry0_img = PhotoImage(file="img_textBox0.png")
print('1')
# ... (the rest of your Tkinter code)
entry0_bg = canvas.create_image(
    737.0, 234.0,
    image = entry0_img)

错误堆栈信息 #

TclError                                  Traceback (most recent call last)
d:\Code\gra-eng\Fre-eng.ipynb Cell 40 line 1
     98 print('1')
     99 # ... (the rest of your Tkinter code)
--> 100 entry0_bg = canvas.create_image(
    101     737.0, 234.0,
    102     image = entry0_img)
    103 result_label = Label(
    104     text="Predicted Translation:",
    105     bg="#ffffff",
    106     font=("Arial", 12)
    107 )
    108 result_label.place(x=558, y=100)

File C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.3056.0_x64__qbz5n2kfra8p0\lib\tkinter\__init__.py:2819, in Canvas.create_image(self, *args, **kw)
   2817 def create_image(self, *args, **kw):
   2818     """Create image item with coordinates x1,y1."""
--> 2819     return self._create('image', args, kw)

File C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.3056.0_x64__qbz5n2kfra8p0\lib\tkinter\__init__.py:2805, in Canvas._create(self, itemType, args, kw)
   2803 else:
   2804     cnf = {}
--> 2805 return self.tk.getint(self.tk.call(
   2806     self._w, 'create', itemType,
   2807     *(args + self._options(cnf, kw))))
TclError: image "pyimage6" doesn't exist

排查与解决方法 #

• 检查Tkinter实例冲突
  从报错路径看你在Jupyter Notebook中运行代码，多次运行会创建多个Tk实例，导致PhotoImage绑定的实例和Canvas所在实例不匹配。解决：

  1. 在代码开头确保只初始化一个主窗口：

     import tkinter as tk
     try:
         root = tk.Tk()
     except:
         root = tk.Toplevel()
     

  2. 每次运行代码前先关闭之前的窗口：root.destroy()

• 防止PhotoImage被垃圾回收
  即使图片加载成功，若PhotoImage对象处于局部作用域，可能被Python垃圾回收机制回收。解决：将PhotoImage绑定到一个持久对象（如Canvas或主窗口）的属性上：

  entry0_img = tk.PhotoImage(file="img_textBox0.png")
  # 绑定到Canvas实例，避免被回收
  canvas.entry0_img = entry0_img
  entry0_bg = canvas.create_image(737.0, 234.0, image=entry0_img)
  

• 尝试在普通.py文件中运行代码
  Jupyter Notebook对Tkinter的兼容性较差，把代码复制到普通Python脚本文件中运行，验证是否是Notebook环境导致的问题。

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