近日，Avalonia UI 社区出现了一个引人关注的技术问题：当开发者在 XAML 中为 TreeDataGrid 控件手动定义列时，控件无法正确解析视图模型（ViewModel）中的属性，导致数据绑定失效。这一问题已在 GitHub 议题、Stack Overflow 及多个开发者论坛引发热议，许多正在迁移或新接触 Avalonia 框架的开发者表示“卡在了基础功能上”。
问题重现：绑定路径被忽略
TreeDataGrid 是 Avalonia UI 提供的一个强大控件，它结合了树形结构（TreeView）与表格（DataGrid）的特性，适用于显示分层数据，如文件系统、组织结构或分类明细。按照官方文档，开发者既可以通过数据自动生成列，也可以在 XAML 中显式定义列结构并绑定到视图模型的属性。
然而，多位用户反馈，当采用后一种方式——即在 <TreeDataGrid.Columns> 内部添加 <TreeDataGridTextColumn> 等列元素，并设置 Binding="{Binding PropertyName}" 时，运行期控件无法解析 PropertyName，列中显示为空或抛出绑定错误。更诡异的是，如果改用代码后台动态添加列并绑定，功能完全正常。
社区深挖：Context 错位与虚拟化冲突
经过社区核心贡献者与多位资深开发者的分析，问题根源可能指向两个层面：
第一，列定义的数据上下文（DataContext）传递异常。 在 XAML 中定义的列，其 Binding 路径默认从 TreeDataGrid 自身的数据上下文出发。但 TreeDataGrid 通常作为 ItemsControl 的子控件嵌入，其 DataContext 已经指向某个视图模型。问题出现在列对象的初始化顺序：当 XAML 解析器创建列实例时，控件的 DataContext 尚未完全建立，导致列绑定的目标上下文为空或错误。而代码后台创建列时，可以显式传入已经就绪的 DataContext。
第二，虚拟化与行模板的协作缺陷。 TreeDataGrid 采用虚拟化技术只为可见行生成 UI。当列在 XAML 中定义时，某些内部路径依赖的“根节点”绑定链路未被正确挂载，导致视图模型属性解析器无法顺着树形层级找到对应属性。这一现象在与层级嵌套较深的数据模型结合时尤为明显。
影响范围：阻碍企业级应用迁移
该问题直接影响采用 MVVM 模式的大型应用开发。例如，某跨国企业正在将财务审核系统从 WPF 迁移至 Avalonia，其 TreeDataGrid 需要展示多级成本中心，每列绑定不同的计算属性。遇到此故障后，团队不得不放弃 XAML 列定义，改用代码生成或自定义模板，大大降低了 XAML 的可读性与设计时预览能力。
“我们本以为 Avalonia 已经足够成熟，没想到这样基础的功能还存在坑。”一位开发者表示。另一位贡献者指出，问题在 Avalonia 11.0 之前的早期版本中就曾出现，但未得到彻底修复，在 11.1 及 11.2 预览版中仍然可复现。
临时解决方案与官方回应
截至目前，Avalonia 团队已在 GitHub 议题 #16834 中标记该问题为“待验证”，并建议开发者在官方修复前采用以下变通方案：
- 使用代码后台定义列：在视图的构造函数或
Loaded事件中，通过treeDataGrid.Columns.Add(new TreeDataGridTextColumn { Binding = new Binding("PropertyName") })实现，确保 DataContext 已就绪。 - 采用 AutoCreateColumns 替代：如果数据模型简单，可设置
AutoCreateColumns="True"让控件自动生成列，但会失去对列顺序、格式的精细控制。 - 嵌套 DataTemplates：将列内容定义为
DataTemplate，通过TreeDataGridTemplateColumn手动绑定，绕开TreeDataGridTextColumn的绑定机制。
官方在最新评论中表示，已定位到“列初始化时未正确继承父级 DataContext”的代码分支，预计将在 Avalonia 11.2 正式版或 11.1 补丁中修复。
开发者启示：框架成熟度仍需检验
此次事件再次提醒跨平台 UI 框架的使用者：在享受 XAML 声明式编程便利的同时，也要警惕框架底层与控件生命周期的微妙交互。对于 Avalonia 团队而言，TreeDataGrid 作为高频使用的企业级控件，其绑定一致性必须达到生产级可靠性。建议正在评估 Avalonia 的团队将“自定义列绑定”作为关键测试用例，避免在项目后期遭遇架构性阻塞。
截至发稿，Avalonia 官方尚未公布精确修复时间线。社区提议通过投票推动该议题优先级。持续关注中。