MacOSX下Python 2.7的Tkinter GUI添加图片时程序冻结问题

我看你在MacOSX + Python2.7环境下，单独测试Tkinter显示图片完全正常，但把图片代码加到登录GUI里就出现了程序冻结的情况。这其实是Tkinter PhotoImage的一个经典陷阱，咱们一步步来搞定它：

问题根源 #

Tkinter的PhotoImage对象有个特殊点：如果它没有被持久化引用（比如只在局部作用域创建，没赋值给全局变量、类属性这类不会被轻易回收的对象），Python的垃圾回收机制会很快把它销毁。这时候Tkinter尝试渲染一个已经被回收的图片对象，就会导致程序冻结或者图片不显示的问题。

你单独测试的脚本里，logo变量处于全局作用域，所以不会被回收；但加到登录GUI时，要是直接把那两行插进去，logo的作用域可能不对，触发了这个回收问题。

修复步骤 #

核心就是给PhotoImage保留持久引用，同时正确插入到你的登录GUI中，修改后的完整脚本如下：

#!/usr/bin/python
from Tkinter import *

root = Tk()
root.title('Login')
root.geometry('450x300')
root.config(bg='light blue')

# 关键：把logo放在全局作用域，避免被垃圾回收
logo = PhotoImage(file="tkinter2.gif")
w1 = Label(root, image=logo).pack(side="right")

def clear_widget(event):
    if username_box == root.focus_get() and username_box.get() == 'Enter Username':
        username_box.delete(0, END)
    # 这里修复了一个笔误：原来的password_box.focus_get()应该是root.focus_get()
    elif password_box == root.focus_get() and password_box.get() == ' ':
        password_box.delete(0, END)

def repopulate_defaults(event):
    if username_box != root.focus_get() and username_box.get() == '':
        username_box.insert(0, 'Enter Username')
    elif password_box != root.focus_get() and password_box.get() == '':
        password_box.insert(0, ' ')

def login(*event):
    username = username_box.get()
    password = password_box.get()
    root.destroy()
    TEST.runKcommands(username, password)

rows = 0
while rows < 10:
    root.rowconfigure(rows, weight=1)
    root.columnconfigure(rows, weight=1)
    rows += 1

username_box = Entry(root,bg="light blue", fg="blue")
username_box.insert(0, 'Enter Username')
username_box.bind("<FocusIn>", clear_widget)
username_box.bind('<FocusOut>', repopulate_defaults)
username_box.grid(row=1, column=5, sticky='NS')

password_box = Entry(root, show='*',bg="light blue", fg="blue")
password_box.insert(0, ' ')
password_box.bind("<FocusIn>", clear_widget)
password_box.bind('<FocusOut>', repopulate_defaults)
password_box.bind('<Return>', login)
password_box.grid(row=2, column=5, sticky='NS')

login_btn = Button(root, text='Login', command=login, bg="light blue")
login_btn.bind('<Return>', login)
login_btn.grid(row=5, column=5, sticky='NS')

root.mainloop()

关键修改点 #

1. 全局保存PhotoImage引用：把logo变量放在全局作用域，让Python不会在创建后立即回收它，保证Tkinter能持续访问这个图片对象。
2. 修复密码框判断笔误：原来clear_widget函数里的password_box == password_box.focus_get()永远不会成立，改成password_box == root.focus_get()后，密码框的清除逻辑才能正常工作。
3. 确认图片路径正确：确保tkinter2.gif和你的脚本在同一个目录下，或者使用绝对路径（比如/Users/你的用户名/Documents/tkinter2.gif）。

额外提示 #

如果你的GUI是用类来构建的，更规范的做法是把PhotoImage赋值给类的实例属性（比如self.logo），同样能避免垃圾回收的问题，也更符合面向对象的编码习惯。

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