StackPanel 顺序堆叠、方向固定，适合线性结构；DockPanel 边缘停靠、顺序敏感，适合区域划分。选错易致错位或响应异常，应据结构意图选择：线性用 StackPanel，分区用 DockPanel。
StackPanel 和 DockPanel 是 Avalonia 中最常用的两种布局控件，但它们的定位逻辑、适用场景和行为表现有本质区别。选错控件容易导致界面错位、空间浪费或响应异常，尤其在动态内容或跨平台适配时更明显。
StackPanel：顺序堆叠，方向固定
它把子控件按 XAML 中声明的顺序，沿单一方向（Horizontal 或 Vertical）依次排列，像一摞卡片。
- 垂直堆叠时，默认每个子控件宽度占满父容器；水平堆叠时，默认高度占满
- 不主动“分配剩余空间”，超出区域的内容会被裁剪（不会自动滚动或换行）
- 子控件尺寸由自身内容 + Margin 决定，不受兄弟控件挤压影响
- 适合简单线性结构，比如表单字段列表、操作按钮组、垂直导航菜单
DockPanel：边缘停靠，顺序敏感
它让子控件“贴边停靠”——顶部、底部、左侧、右侧或中间（填空），类似窗口的标题栏+内容区+状态栏结构。
- 停靠顺序决定布局结果：先停靠的控件占据边缘，后停靠的控件在剩余空间中继续停靠
- 最后一个未指定 Dock 的子控件（或设置了 LastChildFill="True" 的）会自动填充剩余空间
- 同一侧可放多个控件，它们内部按 StackPanel 方式堆叠（例如多个 Button 停靠 Top，会自上而下排列）
- 适合主框架布局，比如顶部工具栏 + 左侧导航 + 右侧内容区 + 底部状态栏
怎么选：看你的结构意图
不需要精确控制位置，只求“一个接一个排下去” → 用 StackPanel。
需要划分明确区域（如菜单停顶、日志停底、主体撑满中间）→ 用 DockPanel。
- 想实现“左图标 + 右按钮”的水平工具栏？StackPanel 更直观
- 想实现“顶部菜单 + 左侧树形导航 + 中间主视图”？DockPanel 更自然
- 两者都能排按钮，但 DockPanel 对窗口缩放更友好——停靠 Top 的控件始终在顶，StackPanel 垂直堆叠可能被挤出可视区
基础用法提醒
所有 Avalonia 布局控件都必须放在 Window.Content 下，且只能有一个直接子元素（所以常嵌套一层 Grid 或 StackPanel 起始）。
- 给控件命名才能在 C# 后台访问：Name="MyButton"，再用 this.FindControl<Button>("MyButton")
- Margin 控制内外间距，HorizontalAlignment/VerticalAlignment 控制对齐方式（仅对父容器有剩余空间时生效）
- DockPanel 子控件需显式设置附加属性：DockPanel.Dock="Top"、DockPanel.Dock="Left" 等
基本上就这些。不复杂但容易忽略顺序和默认行为，动手试两遍比读十遍文档更管用。
