.NET MAUI开发中ShellContent标签无法正常工作问题求助

核心问题原因 #

你当前代码中ShellContent的ContentTemplate属性XAML写法错误，{DataTemplate local:HomePage}不符合MAUI XAML的标记扩展语法规则，无法正确构造HomePage对应的页面实例模板，因此内容加载失败。

正确配置写法 #

优先使用兼容性最高的显式DataTemplate写法，替换App.xaml中原有Shell配置代码如下：

<Application xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
         xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
         xmlns:local="clr-namespace:NSM_Maui"
         x:Class="NSM_Maui.App">

<Application.MainPage>
    <Shell FlyoutBehavior="Flyout" FlyoutHeaderBehavior="Fixed" FlyoutVerticalScrollMode="Auto">
        <FlyoutItem Title="Home">
            <ShellContent>
                <ShellContent.ContentTemplate>
                    <DataTemplate>
                        <local:HomePage />
                    </DataTemplate>
                </ShellContent.ContentTemplate>
            </ShellContent>
        </FlyoutItem>
    </Shell>
</Application.MainPage>
</Application>

如果要使用简写的标记扩展写法，正确格式为{DataTemplate Type={x:Type local:HomePage}}，但该写法在部分旧版MAUI中存在XAML解析bug，非必要不推荐使用。

额外排查项 #

如果替换写法后仍加载异常，逐一检查以下配置：

• 确认HomePage类的命名空间和XAML中local声明的命名空间完全匹配：如果HomePage存放在项目子文件夹（比如Pages文件夹）中，默认生成的类命名空间会带文件夹后缀（如NSM_Maui.Pages），需要对应调整xmlns声明
• 确认HomePage的XAML根节点为ContentPage，后台代码为partial类且正确继承ContentPage，没有写错基类
• 关闭Visual Studio，删除项目根目录下的bin、obj缓存文件夹后重新打开项目生成，避免XAML编译缓存导致的加载异常
• 检查App.xaml.cs后台代码，不要手动重复给MainPage属性赋值，避免和XAML中的Shell配置冲突

内容的提问来源于stack exchange，提问作者TI-84-plus