Tkinter多框架切换时自定义字体无法正常显示问题排查

阿华AIGC实验室

2026-5-28

Tkinter跨框架切换时自定义字体失效的问题解决

我正在用Python的tkinter开发一个简易应用，它包含可切换到新菜单的选项菜单。我采用了切换时销毁旧框架的方案，早期测试版本里能给按钮设置自定义字体并正常显示，但添加了用于切换不同框架的Application主模块后，字体不再生效，按钮文字只是略微变大。

问题根源

你不小心创建了两个独立的Tkinter主窗口实例！看你的代码，你既初始化了root = tk.Tk()，又实例化了继承自tk.Tk的Application类——这会生成两个完全分离的GUI上下文。而Tkinter的Font对象是和它所属的Tk主窗口绑定的，你在root这个窗口下创建的myFont，根本无法在app这个另一个窗口的框架里生效，所以按钮只能 fallback 到默认字体的放大版本，而不是你自定义的字体。

修复方案

步骤1：删除多余的Tk实例

删掉root = tk.Tk()这一行，因为Application本身就是Tk的子类，它会自己创建唯一的主窗口。

步骤2：让Font与正确的主窗口关联

把读取字体配置并创建Font的逻辑整合到Application类中，通过参数传递给子框架，避免使用全局变量（全局变量在多框架场景下很容易引发上下文问题）。

修复后的完整代码

import tkinter as tk
from tkinter.font import Font, nametofont

class Application(tk.Tk):
    def __init__(self):
        tk.Tk.__init__(self)
        self._frame = None
        # 加载自定义字体，确保和当前主窗口绑定
        self.custom_font = self.load_custom_font()
        self.switch_frame(MainMenu)

    def load_custom_font(self):
        # 从配置文件读取字体信息
        try:
            with open("Options.txt", "r") as fontCheck:
                for line in fontCheck:
                    if "Font" in line:
                        tempLine = line.strip()
                        fontDetails = tempLine.split(",")
                        print(fontDetails)
                        return Font(family=fontDetails[1], size=int(fontDetails[2]), weight="bold")
        except FileNotFoundError:
            print("配置文件Options.txt未找到，使用默认字体")
        # 配置读取失败时返回默认字体
        return nametofont("TkDefaultFont")

    def switch_frame(self, frame_class):
        # 传递自定义字体给子框架
        new_frame = frame_class(self, self.custom_font)
        if self._frame is not None:
            self._frame.destroy()
        self._frame = new_frame
        self._frame.grid()

class MainMenu(tk.Frame):
    def __init__(self, master=None, custom_font=None):
        tk.Frame.__init__(self, master)
        self.custom_font = custom_font
        self.grid()
        self.createWidgets()

    def createWidgets(self):
        top = self.winfo_toplevel()
        top.rowconfigure(0, weight=1)
        top.columnconfigure(0, weight=1)
        self.rowconfigure(0, weight=1, pad=50)
        self.columnconfigure(0, weight=1)
        
        self.resume = tk.Button(
            self, text='Continue', height=2, width=10,
            font=self.custom_font, command=self.quit
        )
        self.library = tk.Button(
            self, text='Library', height=2, width=10,
            font=self.custom_font, command=self.quit
        )
        
        self.resume.grid(row=1, column=0, sticky=tk.N+tk.E+tk.W)
        self.library.grid(row=3, column=0, sticky=tk.E+tk.W)

app = Application()
app.mainloop()