在Avalonia中自定义TreeView的节点模板，核心是通过
ItemTemplate（或更准确地说是
TreeDataTemplate）控制每个节点的视觉呈现，同时配合数据结构层级关系实现嵌套展开。它不依赖硬编码UI树，而是靠绑定和模板递归驱动。
用TreeDataTemplate定义层级结构
TreeView默认不支持普通
DataTemplate，必须使用
TreeDataTemplate，因为它内置了
ItemsSource属性用于指定子项集合： ItemsSource必须指向数据模型中的子集合属性，例如
Children、
SubNodes等，类型需为
IEnumerable<t></t>或
ObservableCollection<t></t>模板内部可自由布局：图标、文字、状态指示器等，支持绑定、转换器、事件处理 层级深度由数据本身决定，无需手动创建多层模板
示例：
<TreeView ItemsSource="{Binding RootNodes}">
<TreeView.ItemTemplate>
<TreeDataTemplate ItemsSource="{Binding Children}">
<StackPanel Orientation="Horizontal">
<Image Source="{Binding IconPath}" Width="16" Margin="0 0 4 0"/>
<TextBlock Text="{Binding DisplayName}" VerticalAlignment="Center"/>
</StackPanel>
</TreeDataTemplate>
</TreeView.ItemTemplate>
</TreeView>
为不同类型节点提供差异化模板
当树中包含多种数据类型（如文件夹、文件、配置项），可用
DataType匹配实现自动模板选择： 在
TreeView.ItemTemplate内嵌多个
TreeDataTemplate，各自声明
DataType属性 Avalonia根据绑定项的实际类型自动选取对应模板 确保模型类已正确声明命名空间，并在XAML中导入
示例：
<TreeView ItemsSource="{Binding Items}">
<TreeView.ItemTemplate>
<TreeDataTemplate DataType="models:Folder" ItemsSource="{Binding SubFolders}">
<StackPanel Orientation="Horizontal">
<Image Source="/Assets/folder.png"/>
<TextBlock Text="{Binding Name}"/>
</StackPanel>
</TreeDataTemplate>
<TreeDataTemplate DataType="models:Document" ItemsSource="{Binding Attachments}">
<StackPanel Orientation="Horizontal">
<Image Source="/Assets/doc.png"/>
<TextBlock Text="{Binding Title}"/>
</StackPanel>
</TreeDataTemplate>
</TreeView.ItemTemplate>
</TreeView>
结合$parent绑定获取TreeViewItem上下文
模板内部常需访问父级TreeViewItem的状态（如层级、选中、展开），可通过
$parent[TreeViewItem]语法获取：
{Binding $parent[TreeViewItem].Level} 获取当前节点深度（根为0）
{Binding $parent[TreeViewItem].IsExpanded} 绑定展开状态
{Binding $parent[TreeViewItem].IsSelected} 判断是否被选中
配合Converter可动态控制字体大小、缩进、图标可见性等
常见用途：首层加粗、深层缩进、仅二级显示小图标等。
避免常见错误
实际开发中容易踩坑的地方：
误用DataTemplate代替TreeDataTemplate：会导致子节点无法渲染或报绑定错误 ItemsSource绑定路径不存在或为空集合：节点不展开，但也不报错，需检查数据模型 未设置DataContext或绑定源为null：整个TreeView空白，建议先用静态数据验证模板 模板内元素未设宽高或Margin导致重叠：尤其在水平StackPanel中，文字过长易溢出，推荐加TextTrimming="CharacterEllipsis"
