Avalonia 本身不内置 Docking 功能,需通过第三方库 Avalonia.Dock 实现专业停靠界面;它支持拖拽、标签页、布局序列化,模仿 Visual Studio 布局体验,是当前最成熟稳定的方案。

Avalonia 本身不内置 Docking(停靠)功能,但可以通过第三方库 Avalonia.Dock 实现专业、可拖拽、可停靠、支持标签页和布局序列化的多窗格界面。它模仿 Visual Studio 或 Rider 的布局体验,是目前 Avalonia 生态中最成熟稳定的停靠方案。
安装 Avalonia.Dock
在项目中通过 NuGet 安装核心包:
- Avalonia.Dock:核心控件与布局逻辑
- Avalonia.Dock.Controls(可选):提供预置的工具栏、标题栏等 UI 组件
- Avalonia.Xaml.Behaviors(如需行为绑定,推荐搭配使用)
安装后,在 XAML 中添加命名空间引用:
基础停靠布局结构
核心是 DockManager + LayoutRoot + LayoutPanel + LayoutDocumentPane / LayoutAnchorablePane。典型结构如下:
- DockManager 是根容器,管理整个停靠系统状态
- LayoutRoot 是唯一子元素,代表当前布局拓扑
- LayoutPanel 表示一个可分割的区域(水平/垂直),内部可嵌套其他 Panel 或 Pane
- LayoutDocumentPane 用于承载「文档式」内容(如编辑器标签页),支持关闭、最大化、新建标签
- LayoutAnchorablePane 用于承载「工具窗口式」内容(如属性面板、解决方案资源管理器),可浮动、自动隐藏、停靠到边缘
定义可停靠内容(Anchorable)
每个可停靠窗口需封装为 LayoutAnchorable,并设置 Title、Icon、CanFloat、CanAutoHide 等属性:
注意:LayoutAnchorable 必须放在 LayoutAnchorablePane 内,或由 DockManager 动态添加(例如通过菜单命令打开)。
保存与恢复布局
调用 DockManager.Save() 可序列化当前布局为 XML 字符串;DockManager.Load(xml) 可还原。建议在应用退出前保存到本地文件,启动时尝试加载:
- 保存路径推荐使用
AppData目录下的 JSON/XML 文件 - 首次运行无配置时,可预设默认布局(如左窗格放资源树、右窗格放属性、中央放编辑器)
- 注意处理
LayoutContent类型反序列化失败问题——确保所有自定义视图类型已注册或可通过默认构造函数实例化










