如何在 tk.Frame 中正确嵌入 ttk.Notebook 组件

日期：2026-01-20 00:00 / 作者：霞舞

本文详解如何将 `ttk.notebook` 成功添加到 `tk.frame` 中，涵盖创建、布局、标签页添加及关键注意事项，附可运行代码示例。

在 Tkinter 中，ttk.Notebook 是一个容器型控件，用于实现多标签页界面。它本身不直接“显示内容”，而是作为标签页的管理器——你需要先创建 Notebook 实例，再通过 pack/grid/place 将其布局到父容器（如 tk.Frame）中，最后向其添加子 Frame 作为各个标签页的内容区域。

关键点在于：仅实例化 ttk.Noteb

ook(self.frame0) 并不够；必须显式调用布局方法（如 .grid() 或 .pack()），否则组件不会渲染。

以下是在你原有 MyApp 类中集成 Notebook 的完整修正示例（基于 grid 布局，兼顾灵活性与可扩展性）：

import tkinter as tk
from tkinter import ttk

class MyApp(tk.Tk):
    def __init__(self):
        super().__init__()
        self.title("hello world")

        # 创建两个主 Frame
        self.frame0 = tk.Frame(self, background="green")
        self.frame1 = tk.Frame(self, background="blue")

        self.frame0.pack(side="top", fill="both", expand=True)
        self.frame1.pack(side="top", fill=tk.X, expand=True)

        # 在 frame0 中创建并布局 Notebook
        self.tabControl = ttk.Notebook(self.frame0)
        self.tabControl.grid(row=0, column=0, sticky="nsew", padx=2, pady=2)

        # 配置 grid 权重，确保 Notebook 可随窗口缩放
        self.frame0.grid_rowconfigure(0, weight=1)
        self.frame0.grid_columnconfigure(0, weight=1)

        # 创建标签页内容 Frame
        self.tab1 = tk.Frame(self.tabControl, background="#f0f0f0")
        self.tab2 = tk.Frame(self.tabControl, background="#e0e0e0")

        # 添加标签页（注意：顺序决定默认选中项）
        self.tabControl.add(self.tab1, text="Tab 0")
        self.tabControl.add(self.tab2, text="Tab 1")

        # 在各标签页中添加示例内容
        tk.Label(self.tab1, text="Content of Tab 0", font=("Arial", 10)).pack(pady=20)
        tk.Label(self.tab2, text="Content of Tab 1", font=("Arial", 10)).pack(pady=20)

        # frame1 中保留原 "OTHER" 标签
        self.frame1_label0 = tk.Label(self.frame1, text="OTHER", font=("Arial", 12))
        self.frame1_label0.grid(row=0, column=0, padx=10, pady=5)

def main():
    app = MyApp()
    app.minsize(480, 320)  # 设置最小尺寸，避免 Notebook 被压缩不可见
    app.mainloop()

if __name__ == "__main__":
    main()

? 重要注意事项：

✅ 必须布局：ttk.Notebook 实例创建后，务必调用 .grid() / .pack() / .place()，否则不可见；
✅ 权重配置：若使用 grid，需为父 Frame 设置 rowconfigure 和 columnconfigure 的 weight=1，否则 Notebook 不会随窗口拉伸；
✅ 子 Frame 必须归属 Notebook：每个 tab 的内容 Frame 应以 self.tabControl 为父容器（而非 self.frame0），否则无法被 Notebook 管理；
⚠️ 避免混用布局管理器：同一父容器内不要同时对子组件使用 pack() 和 grid()，否则会引发 TclError；
? 提示：可通过 self.tabControl.select(tab_index) 或 self.tabControl.select(tab_id) 编程切换当前页。