Avalonia 的 TabControl 以声明式 XAML 结构为核心，要求 TabItem 为唯一直接子元素，Header 和 Content 分离，支持 TabStripPlacement 控制标签位置，推荐绑定 SelectedIndex/SelectedItem 实现 MVVM，样式调试需借助 F12 Inspector。
Avalonia 的 TabControl 是组织多页内容的核心控件，用法简洁但细节关键。它不依赖 winForms 那套 TabPage 实例化逻辑，而是基于 XAML 声明式结构 + MVVM 友好绑定，重点在于 TabItem 的正确嵌套和样式控制。
基础结构：TabItem 必须直接子元素
TabControl 只接受 TabItem 作为直接子元素，不能直接放 TextBlock 或 StackPanel。每个 TabItem 有两部分：Header（标签标题）和 Content（页内内容）。
- Header 可以是纯文本：
- Header 也可用控件自定义：
设置 - Content 区域写在
布局方向：用 TabStripPlacement 控制标签位置
默认标签在顶部，但可通过 TabStripPlacement 属性改为左、右、底部，适合不同 ui 场景：
-
TabStripPlacement="Top"（默认） -
TabStripPlacement="Bottom"—— 标签移到下方 -
TabStripPlacement="Left"—— 垂直排列，节省横向空间 -
TabStripPlacement="Right"—— 同样垂直，适合右侧辅助面板
注意：设为 Left/Right 时，建议配合 Width 或 MinWidth 控制标签栏宽度，避免内容被压缩。
选中与切换：绑定 SelectedIndex 或 SelectedItem
推荐用 MVVM 方式管理当前页状态，而不是代码后台硬编码：
- 绑定
SelectedIndex到 ViewModel 中的int属性，实现双向同步 - 或绑定
SelectedItem到一个TabItem类型属性（需配合x:Name或数据模板） - 代码中手动切换：
tabControl.SelectedIndex = 1;或tabControl.SelectedItem = tabItem2;
如果需要响应切换事件，可监听 SelectionChanged，但多数场景下绑定更干净。
样式与颜色：别猜，用 F12 可视化调试
TabItem 文字颜色、背景、选中态等常被默认样式覆盖，直接写 TabItem:selected 容易失效：
- 运行程序后按 F12 打开 Avalonia Inspector
- 悬停到目标 TabItem，右键 → “copy Template” 获取完整样式路径
- 在
Styles.xaml中粘贴并修改对应Foreground、background等属性 - 利用右下角 Pseudo Classes 面板勾选
selected、mouseover实时预览效果
基本上就这些。用对结构、选对方向、绑对状态、调对样式，TabControl 就很听话。