使用Tkinter构建GUI添加文本框时提示‘图片不存在’问题排查

问题场景与报错 #

在使用Tkinter构建GUI并尝试给图片添加文本框时，反复遇到「图片不存在」的错误提示，具体报错信息为：

TclError: image "pyimage9" doesn't exist

已排查无效操作 #

• 确认图片文件路径完全正确，调用image.show()可以正常打开并显示图片
• 尝试修改路径写法（切换绝对路径/相对路径）
• 将图片文件移动至代码所在的同目录下
  以上操作均无法消除报错。

根因定位 #

最终发现问题根源是代码被多次执行。

Tkinter的图像对象（如PhotoImage）与Tcl解释器实例绑定，当代码重复执行时，新创建的Tk实例会复用旧的Tcl上下文，导致之前的图像对象被销毁或引用失效，进而触发该错误。

可行解决方案 #

1. 确保Tk实例唯一：避免在循环、重复调用的函数中创建Tk()主窗口，若需多窗口，改用Toplevel()创建子窗口
2. 保留图像对象引用：将图像对象赋值给全局变量或类实例属性，防止被Python垃圾回收机制回收
3. 重置解释器上下文：如果是在交互式环境（如Jupyter Notebook）中重复运行代码，重启内核可彻底清除旧的Tcl上下文

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