Tkinter类实例化后仅显窗口标题，无背景文本且无报错求排查

问题描述 #

学习Python的tkinter模块与面向对象编程时，编写了Page类用于创建可操作窗口，使用Canvas实现窗口背景，但实例化类后仅显示窗口标题，背景为空、无文本显示，控制台无错误输出。

原始代码 #

import tkinter as tk
from tkinter import * 
import PIL
hello_text = 'some text'

start_page_titel = 'some text'

class Page:
    def __init__(self, title_of, g_x, g_y):
        self.title_of = title_of
        self.g_x = g_x
        self.g_y = g_y
    
    
        self.window = tk.Tk()
        self.win_bg = PhotoImage(file = 'some pic.png')
       
        self.window.title(title_of)
        self.window.geometry(f'{g_x}x{g_y}+300+300')
        self.window.resizable(False, False)
        
        self.canv_win = tk.Canvas(self.window, width = g_x, height = g_y)
        
        self.canv_win.create_image(0, 0, image = self.win_bg, anchor = 'nw' )
    
    
    def text_for(self, txt_x, txt_y, some_text):
        self.canv_win.create_text(txt_x, txt_y, text = some_text, fill = 'white')
        
    
    def start(self):
        self.window.mainloop()
        
    
    def stop(self):
        self.window.destroy()

start_page = Page(start_page_titel, 1024, 655)
start_page.text_for(350,50, hello_text)    
start_page.start()

问题原因与修复 #

• Canvas未完成布局：创建Canvas对象后，没有调用pack()、grid()或place()这类布局方法，窗口无法识别并渲染这个Canvas组件，导致背景和文本都无法显示，这是核心问题。
• 图片路径验证：需确保some pic.png文件存在于当前工作目录，或使用完整文件路径（如./images/some pic.png），否则背景会空白。另外PhotoImage对象已通过self.win_bg保留引用，不会被垃圾回收，这部分无需修改。

修复后的代码 #

import tkinter as tk
from tkinter import * 

hello_text = 'some text'
start_page_titel = 'some text'

class Page:
    def __init__(self, title_of, g_x, g_y):
        self.title_of = title_of
        self.g_x = g_x
        self.g_y = g_y
    
        self.window = tk.Tk()
        # 确保图片路径正确，文件存在
        self.win_bg = PhotoImage(file='some pic.png')
       
        self.window.title(title_of)
        self.window.geometry(f'{g_x}x{g_y}+300+300')
        self.window.resizable(False, False)
        
        self.canv_win = tk.Canvas(self.window, width=g_x, height=g_y)
        # 关键步骤：将Canvas添加到窗口布局，这里用pack适配窗口大小
        self.canv_win.pack(fill=tk.BOTH, expand=True)
        
        self.canv_win.create_image(0, 0, image=self.win_bg, anchor='nw')
    
    def text_for(self, txt_x, txt_y, some_text):
        # 增加字体参数，避免白色文本因字号太小看不清
        self.canv_win.create_text(txt_x, txt_y, text=some_text, fill='white', font=('Arial', 12))
        
    def start(self):
        self.window.mainloop()
        
    def stop(self):
        self.window.destroy()

start_page = Page(start_page_titel, 1024, 655)
start_page.text_for(350,50, hello_text)    
start_page.start()

额外说明 #

如果需要加载JPG等PhotoImage不支持的格式，需使用PIL库处理，同时要保留对Image对象的引用：

from PIL import Image, ImageTk
# 在__init__中替换图片加载代码：
img = Image.open('some pic.jpg')
self.win_bg = ImageTk.PhotoImage(img)

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