Tkinter嵌套Frame+Grid管理器出现重叠与间距不均问题

问题根源 #

1. 组件挂载层级混乱：Square按钮创建时未指定父容器为BoardFrame，直接挂载到主窗口导致与TitleFrame重叠；TitleFrame、BoardFrame未绑定到Window实例，而是直接归属主窗口，破坏嵌套结构。
2. 网格权重未配置：主窗口、嵌套Frame未设置行/列权重，导致按钮间距不均，布局无法自适应窗口大小。
3. Window实例未挂载：自定义Window Frame创建后未添加到主窗口布局，内部组件直接脱离嵌套逻辑。

修复步骤 #

1. 修正组件父容器：
   • 创建TitleFrame、BoardFrame时指定master=self（当前Window实例），确保嵌套层级正确。
   • Square类新增master参数，创建按钮时将父容器指定为BoardFrame，让按钮归属于棋盘区域。
2. 配置网格权重：
   • 为主窗口、Window、BoardFrame的行/列设置权重，分配空间占比，保证按钮均匀分布且布局自适应窗口。
3. 挂载Window实例：将创建的Window对象添加到主窗口的网格布局中，激活嵌套结构。

完整修正代码 #

from tkinter import *

class Square(Button):
    def __init__(self, master, rank, file, bg="white", startingPiece = None) -> None:
        super().__init__(master=master, text="T", bg=bg, borderwidth=2)
        self.Piece = startingPiece or None
        self.IsSelected = False
        self.rank = rank
        self.file = file

class Window(Frame):
    def __init__(self, master=None):
        super().__init__(master)
        self.master = master
        # 配置主窗口网格权重
        self.master.rowconfigure(0, weight=1)
        self.master.columnconfigure(0, weight=1)
        # 配置Window自身的行权重：标题栏不占额外空间，棋盘区占剩余全部空间
        self.rowconfigure(0, weight=0)
        self.rowconfigure(1, weight=1)
        self.columnconfigure(0, weight=1)
        self.CreateGrid()

    def CreateGrid(self):
        # 绑定父容器为当前Window实例
        self.TitleFrame = Frame(self)
        self.BoardFrame = Frame(self)
        self.TitleFrame.grid(row=0, column=0, sticky='news')
        self.BoardFrame.grid(row=1, column=0, sticky='news')

        self.TitleFrame.Title = Label(self.TitleFrame, text="Chess Bot Viewer")
        self.TitleFrame.Title.grid(row=0, column=0, sticky='news')

        # 配置BoardFrame的8行8列权重，保证按钮均匀分配空间
        for i in range(8):
            self.BoardFrame.rowconfigure(i, weight=1)
            self.BoardFrame.columnconfigure(i, weight=1)

        self.BoardFrame.Squares = [[0 for x in range(8)] for y in range(8)] 
        doFillBG = True
        for x in range(8):
            doFillBG = not doFillBG
            for y in range(8):
                bg = 'gray' if doFillBG else 'white'
                # 传入BoardFrame作为按钮父容器
                self.BoardFrame.Squares[x][y] = Square(master=self.BoardFrame, rank=x, file=y, bg=bg)
                self.BoardFrame.Squares[x][y].grid(row=x, column=y, sticky='news')
                doFillBG = not doFillBG

root = Tk()
app = Window(root)
# 将Window实例挂载到主窗口
app.grid(row=0, column=0, sticky='nsew')
root.wm_title("Chess")
root.geometry("400x400")
root.mainloop()

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