Tkinter如何为UI窗口添加背景图片并让控件置于图片上方

两种方案都能实现「所有UI控件显示在背景图之上」的效果，核心是规避两个高频踩坑点：背景层必须放在最底层、图片对象必须保留引用防止被垃圾回收。

方案1：Canvas实现（适配复杂布局，自由度最高） #

核心逻辑：

• 用Canvas作为全窗口底层层级
• 背景图通过create_image绘制在Canvas最底层
• 所有业务控件通过Canvas的create_window方法挂载，不会被背景遮挡

适配现有代码的实现片段：

import rotors
import tkinter as tk
from tkinter import HORIZONTAL
import tkinter.messagebox as mbx
import pyperclip
# 处理非PNG/GIF格式图片需先安装Pillow：pip install pillow
from PIL import Image, ImageTk

class UI():    
    def __init__(self, window, encryption):
        self.encryption = encryption
        self.window = window
        self.window.title('Security Window')
        self.window.minsize(width = 500, height = 200)
        self.x = tk.StringVar() 

        # 背景图配置开始
        # 1. 创建铺满整个窗口的Canvas
        self.bg_canvas = tk.Canvas(self.window, width=500, height=200)
        self.bg_canvas.pack(fill="both", expand=True)
        # 2. 加载背景图，替换为你自己的图片路径，可根据窗口尺寸做自适应缩放
        bg_source = Image.open("your_bg_image.png").resize((500, 200))
        # 注意：图片对象必须绑定为类实例属性，不能用局部变量，否则会被垃圾回收导致空白
        self.bg_img = ImageTk.PhotoImage(bg_source)
        # 3. 将背景图绘制到Canvas最底层，锚点设为左上角
        self.bg_canvas.create_image(0, 0, image=self.bg_img, anchor="nw")
        # 背景图配置结束

        # 后续添加控件示例，不要直接pack/grid到根窗口，挂载到Canvas上即可
        demo_entry = tk.Entry(self.bg_canvas, textvariable=self.x)
        # 指定控件在Canvas上的坐标位置
        self.bg_canvas.create_window(250, 100, window=demo_entry)

方案2：Label实现（适合简单布局，代码量更少） #

核心逻辑：

• 用Label作为背景载体，通过place布局铺满全窗口
• 先初始化背景Label保证其在最底层，后续控件创建后通过lift()方法提升层级即可

实现片段：

# 接上述类的__init__方法，替换背景配置部分即可
# 1. 创建背景Label，用place铺满整个窗口
self.bg_label = tk.Label(self.window)
self.bg_label.place(x=0, y=0, relwidth=1, relheight=1)
# 2. 加载图片，同样需要绑定为实例属性防止被回收
bg_source = Image.open("your_bg_image.png").resize((500, 200))
self.bg_img = ImageTk.PhotoImage(bg_source)
self.bg_label.config(image=self.bg_img)

# 后续控件可正常用pack/grid布局，若被遮挡调用lift()提升层级即可
demo_entry = tk.Entry(self.window, textvariable=self.x)
demo_entry.pack(pady=50)
demo_entry.lift()

常见问题排查 #

• 图片显示空白：90%情况是图片对象用了局部变量，方法执行完被Python垃圾回收，必须把图片对象绑定为self.xxx的实例属性
• 图片格式不支持：Tkinter原生仅支持PNG、GIF格式，使用JPG等其他格式必须通过Pillow库转码
• 控件被背景遮挡：对控件调用.lift()方法强制提升层级，对背景组件调用.lower()方法强制置底
• 窗口缩放后背景不匹配：可以给窗口绑定<Configure>事件，触发时重新计算窗口尺寸、缩放背景图重绘即可

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