.NET Maui ListView在Android设备及模拟器中不显示的解决方法

你的代码存在几个核心问题，直接导致了ListView的Header和内容在Android上无法正常显示，以下是对应的解决思路和修正方案：

问题1：ListView嵌套在ScrollView中 #

ListView本身自带滚动功能，将其嵌套在ScrollView里会触发布局冲突，Android平台对这种嵌套的兼容性较差，直接导致控件无法正常渲染。必须移除外层的ScrollView。

问题2：VerticalStackLayout的VerticalOptions设置不合理 #

原代码中VerticalOptions="Center"会让布局容器尝试居中对齐，导致ListView无法获得足够的垂直空间来展示内容。需要将其改为FillAndExpand，让ListView能占据父容器的可用空间。

问题3：ListView缺少数据源与明确的布局约束 #

即使定义了ItemTemplate，没有数据源的话内容不会显示；同时在Android上，ListView需要明确的空间约束才能正常渲染。另外，Header直接写纯文本的渲染兼容性不佳，建议包装在Label等View控件中。

修正后的完整代码 #

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="Listv.MainPage">

    <VerticalStackLayout
        Spacing="25"
        Padding="30,0"
        VerticalOptions="FillAndExpand">

        <ListView VerticalOptions="FillAndExpand">
            <ListView.Header>
                <Label Text="TheHeader" FontSize="Large" FontAttributes="Bold"/>
            </ListView.Header>
            <ListView.ItemTemplate>
                <DataTemplate>
                    <ViewCell>
                        <Label Text="{Binding .}" Margin="10"/>
                    </ViewCell>
                </DataTemplate>
            </ListView.ItemTemplate>
            <!-- 添加测试数据，实际项目可绑定ViewModel中的集合 -->
            <ListView.ItemsSource>
                <x:Array Type="{x:Type x:String}">
                    <x:String>Item 1</x:String>
                    <x:String>Item 2</x:String>
                    <x:String>Item 3</x:String>
                </x:Array>
            </ListView.ItemsSource>
        </ListView>

    </VerticalStackLayout>
</ContentPage>

额外说明 #

• 如果你的数据来自ViewModel，只需将ItemsSource绑定到对应的ObservableCollection属性即可，无需手动编写x:Array。
• 保持ListView的VerticalOptions="FillAndExpand"，确保它能填充父容器的剩余空间，避免被压缩导致显示异常。

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