Tkinter开发密码管理器时主窗口图片无法显示求助

问题情况 #

开发Tkinter密码管理器时，主窗口中无法显示图片，代码无报错但图片不出现：

• 用简化测试代码时图片能正常显示
• 图片放在脚本同目录下提示「权限拒绝」（调整权限无效）
• 图片放目录外时代码能运行，但仍无图片显示
• 改用PIL库加载图片，结果依旧

主代码 #

import tkinter as tk
import os
# 假设RegistrationWindow已定义
class RegistrationWindow:
    def __init__(self, master, callback):
        self.master = master
        self.callback = callback
        self.frame = tk.Frame(master)
        
    def show_frame(self):
        self.frame.pack()
        
    def hide_frame(self):
        self.frame.pack_forget()

class MainMenu:
    def __init__(self, master):
        self.master = master
        self.master.title("Password Manager")

        self.main_menu_frame = tk.Frame(master)
        self.main_menu_frame.pack()

        script_path = os.path.dirname(os.path.abspath(__file__))
        image_path = os.path.join(script_path, "PyLock.png")

        canvas = tk.Canvas(self.main_menu_frame, width=200, height=200)
        canvas.grid(row=0, column=1)

        pylock_img = tk.PhotoImage(file="PyLock.png")
        canvas.create_image(100, 100, image=pylock_img)

        self.register_button = tk.Button(self.main_menu_frame, text="Register a New User", command=self.show_registration_frame)
        self.register_button.grid(row=1, column=1)

        self.login_button = tk.Button(self.main_menu_frame, text="Log In", command=self.login_button_click)
        self.login_button.grid(row=2, column=1)

        self.exit_button = tk.Button(self.main_menu_frame, text="Exit", command=self.exit_button_click)
        self.exit_button.grid(row=3, column=1)

        self.registration_frame = RegistrationWindow(self.master, self.show_main_menu_frame)

    def show_registration_frame(self):
        self.main_menu_frame.pack_forget()
        self.registration_frame.show_frame()

    def login_button_click(self):
        print("Login button clicked")

    def exit_button_click(self):
        self.master.destroy()

    def show_main_menu_frame(self):
        self.registration_frame.hide_frame()
        self.main_menu_frame.pack()

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

测试代码（可正常显示图片） #

import tkinter as tk
import os

class MainMenu:
    def __init__(self, master):
        self.master = master
        self.master.title("Password Manager")

        print(os.getcwd())
        self.main_menu_frame = tk.Frame(master)
        self.main_menu_frame.pack()

        script_path = os.path.dirname(os.path.abspath(__file__))
        image_path = os.path.join(script_path, "PyLock.png")

        canvas = tk.Canvas(self.main_menu_frame, width=200, height=200)
        canvas.grid(row=0, column=1)

        pylock_img = tk.PhotoImage(file="PyLock.png")
        canvas.create_image(100, 100, image=pylock_img)

        root.mainloop()

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

尝试过的PIL加载代码 #

canvas = tk.Canvas(self.main_menu_frame, width=200, height=200)
canvas.grid(row=0, column=1)

image_path = "PyLock.png"
pil_image = Image.open(image_path)

pylock_img = ImageTk.PhotoImage(pil_image)
canvas.create_image(100, 100, image=pylock_img)

核心问题与解决方法 #

1. PhotoImage垃圾回收问题 #

测试代码能运行是因为root.mainloop()在__init__方法内，局部变量pylock_img不会被Python垃圾回收机制回收。但主代码中__init__执行完毕后，局部变量pylock_img会被销毁，导致图片无法显示。

解决：将图片对象绑定为实例属性
把pylock_img改为self.pylock_img，让实例持有图片对象的引用，避免被回收。

2. 图片路径问题 #

主程序运行时的工作目录可能和脚本所在目录不一致，直接用相对路径"PyLock.png"会导致找不到文件。需要使用之前生成的绝对路径image_path加载图片。

3. 权限拒绝问题 #

• 检查图片文件是否被其他程序占用（比如图片查看器）
• 确认当前用户对图片文件有读取权限（Linux/macOS可执行chmod +r PyLock.png）
• Windows下可尝试右键图片→属性→安全，确保当前用户有读取权限

修改后的代码示例（Tkinter原生加载） #

# 替换主代码中图片加载部分
script_path = os.path.dirname(os.path.abspath(__file__))
image_path = os.path.join(script_path, "PyLock.png")

canvas = tk.Canvas(self.main_menu_frame, width=200, height=200)
canvas.grid(row=0, column=1)

# 使用绝对路径，并绑定到实例属性
self.pylock_img = tk.PhotoImage(file=image_path)
canvas.create_image(100, 100, image=self.pylock_img)

修改后的代码示例（PIL加载） #

from PIL import Image, ImageTk

# 替换主代码中图片加载部分
script_path = os.path.dirname(os.path.abspath(__file__))
image_path = os.path.join(script_path, "PyLock.png")

canvas = tk.Canvas(self.main_menu_frame, width=200, height=200)
canvas.grid(row=0, column=1)

pil_image = Image.open(image_path)
self.pylock_img = ImageTk.PhotoImage(pil_image)
canvas.create_image(100, 100, image=self.pylock_img)

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