MAUI ListView绑定报错：在WorkoutsViewModel中找不到Name/Description属性

出现这个绑定错误的核心原因是**x:DataType的作用域设置错误**，导致绑定上下文指向了WorkoutsViewModel而非WorkoutCategory。以下是具体排查点和修复方案：

1. 检查x:DataType的位置 #

你可能把x:DataType错误地设置在了ListView标签上，而非ItemTemplate内部的DataTemplate上。因为ListView的默认DataContext是WorkoutsViewModel，如果在ListView层级指定x:DataType，编译器会默认从ViewModel中查找Name/Description属性，自然找不到。

错误示例： #

<ListView x:DataType="local:WorkoutsViewModel" ItemsSource="{x:Bind WorkoutCategories}">
    <ListView.ItemTemplate>
        <DataTemplate>
            <StackPanel>
                <TextBlock Text="{x:Bind Name}" />
                <TextBlock Text="{x:Bind Description}" />
            </StackPanel>
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

正确示例： #

把x:DataType移到DataTemplate标签上，明确每个列表项的类型是WorkoutCategory：

<ListView ItemsSource="{x:Bind WorkoutCategories}">
    <ListView.ItemTemplate>
        <DataTemplate x:DataType="local:WorkoutCategory">
            <StackPanel>
                <TextBlock Text="{x:Bind Name}" />
                <TextBlock Text="{x:Bind Description}" />
            </StackPanel>
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

2. 确认命名空间引用正确 #

检查XAML顶部的命名空间声明，确保local（或你自定义的前缀）正确指向WorkoutCategory所在的命名空间：

xmlns:local="using:BoxingTimer"

如果命名空间写错，编译器无法识别WorkoutCategory类型，会自动回退到父级DataContext（即WorkoutsViewModel），从而触发绑定错误。

3. 验证WorkoutCategory属性的可访问性 #

确保WorkoutCategory的Name、Description属性是公共属性，如果需要属性更新通知，还需实现INotifyPropertyChanged接口：

namespace BoxingTimer
{
    public class WorkoutCategory
    {
        public string Name { get; set; }
        public string Description { get; set; }
        // 可选：实现INotifyPropertyChanged以支持属性更新通知
    }
}

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