最简路径是直接实例化ttk.notebook并用add()添加frame子容器，需手动布局、设text标题、调select()指定默认页；tab内控件必须以对应frame为master，否则不显示。
怎么用 ttk.Notebook 创建基础选项卡
直接实例化 ttk.Notebook，再用 add() 方法塞入子控件——这是最简路径。注意：子控件必须是容器（比如 Frame），不能直接加按钮或标签。
-
ttk.Notebook本身不管理布局，得手动调用.pack()或.grid()把它放进去 - 每个 tab 的标题用
text参数控制，别写成title（那是Toplevel的） - 加完 tab 后记得调用
.select()指定默认激活页，否则可能黑屏或显示空白
import tkinter as tk from tkinter import ttk <p>root = tk.Tk() notebook = ttk.Notebook(root) notebook.pack(fill="both", expand=True)</p><p>tab1 = ttk.Frame(notebook) tab2 = ttk.Frame(notebook) notebook.add(tab1, text="首页") notebook.add(tab2, text="设置") notebook.select(tab1) # 必须加 </p>
为什么 notebook.tab() 和 notebook.index() 总返回 None 或报错
这两个方法只在 tab 已添加且索引有效时才工作。常见误操作是：没等 add() 完就查索引，或传了错误类型参数（比如用字符串查不存在的 tab 名）。
-
notebook.index("end")返回当前总页数，但"end"不是整数，不能当列表下标直接用 -
notebook.tab(0, "text")可读取第 0 页标题，但notebook.tab("首页", "text")会失败——名字不是键，得先用notebook.index("首页")转成序号 - 删除 tab 后，剩余页的索引会自动前移，缓存旧索引会导致
IndexError
切换 tab 时怎么触发自定义逻辑（比如刷新数据）
ttk.Notebook 不自带 on_change 回调，得监听 <notebooktabchanged></notebooktabchanged> 事件。这个事件在用户点击、键盘切换、或代码调用 .select() 后都触发，但不会在初始化时触发。
- 绑定要写在
notebook实例上，不是某个 tab 上 - 事件对象
event.widget就是 notebook 本身，用event.widget.index("current")拿当前页序号 - 避免在回调里反复调用
.select()，否则可能造成无限循环切换
def on_tab_changed(event):
idx = event.widget.index("current")
print(f"切换到第 {idx} 页")
<p>notebook.bind("<notebooktabchanged>", on_tab_changed)
</notebooktabchanged></p>
为什么 tab 里的控件不显示 / 布局错乱
根本原因：tab 内部的 Frame 没有被正确布局，或者子控件没挂到该 Frame 上（而是挂到了 root 或 notebook 本身）。
- 所有 tab 内控件的
master参数必须是对应Frame，例如ttk.Button(tab1, text="点我") -
Frame默认尺寸为 0×0，如果里面没控件或没调.pack()/.grid()，它就不可见 - 别对 notebook 用
.place()，它和pack/grid混用极易导致 tab 区域塌陷 - macOS 下有时需给 tab
Frame设padding，否则边框贴边难看
Tkinter 的 tab 系统本身轻量，但父子关系和布局链非常敏感——漏掉一次 .pack()、错绑一个 master、或事件监听位置不对，都会让整个页面“静音”失效。真正麻烦的从来不是加几个 tab，而是确认每一层容器是否真的活在它该在的位置上。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
