MAUI中无法在BindableLayout的DataTemplate内使用FlexLayout

可能的问题原因及排查方案： #

• XAML语法错误
  这是最常见的触发原因，比如FlexLayout标签未闭合、属性拼写错误（例如把Direction写成Directon）。先简化DataTemplate内容，用最基础的FlexLayout写法测试：

  <BindableLayout.ItemTemplate>
      <DataTemplate>
          <FlexLayout>
              <Label Text="测试内容" />
          </FlexLayout>
      </DataTemplate>
  </BindableLayout.ItemTemplate>
  

  如果能正常启动，再逐步添加属性、绑定内容，定位具体出错的代码段。

• 命名空间冲突或缺失
  确保XAML根元素已包含MAUI核心命名空间（默认自动生成，若手动修改过需确认）：

  xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
  

  如果项目中存在自定义的FlexLayout类，会和系统控件重名，此时需要用完整命名空间指定控件：

  <Microsoft.Maui.Controls.FlexLayout>
      <!-- 内部控件 -->
  </Microsoft.Maui.Controls.FlexLayout>
  

• DataTemplate结构不符合要求
  BindableLayout的ItemTemplate要求根元素是单个可视化控件，FlexLayout本身满足这个条件，但不要在DataTemplate中直接放置多个未包裹的元素。

• 缓存或编译问题
  清理项目的bin和obj文件夹，重新生成解决方案，MAUI的XAML缓存偶尔会引发这类无明确提示的错误。

正确示例代码 #

以下是可正常运行的BindableLayout+FlexLayout写法：

XAML部分

<StackLayout BindableLayout.ItemsSource="{Binding MyItemList}">
    <BindableLayout.ItemTemplate>
        <DataTemplate>
            <FlexLayout Direction="Row" AlignItems="Center" Padding="8" Spacing="6">
                <Image Source="{Binding Icon}" WidthRequest="24" HeightRequest="24" />
                <Label Text="{Binding Title}" FontSize="16" />
                <Label Text="{Binding Count}" Margin="0,0,10,0" HorizontalOptions="EndAndExpand" />
            </FlexLayout>
        </DataTemplate>
    </BindableLayout.ItemTemplate>
</StackLayout>

C# ViewModel部分

public class MyViewModel
{
    public ObservableCollection<MyItem> MyItemList { get; set; }

    public MyViewModel()
    {
        MyItemList = new ObservableCollection<MyItem>
        {
            new MyItem { Icon = "icon1.png", Title = "项目1", Count = "5" },
            new MyItem { Icon = "icon2.png", Title = "项目2", Count = "3" }
        };
    }
}

public class MyItem
{
    public string Icon { get; set; }
    public string Title { get; set; }
    public string Count { get; set; }
}

内容的提问来源于stack exchange，提问作者0fail