.NET MAUI：FlyoutItem仅显示单个ShellContent标签页配置求助

问题原因 #

.NET MAUI Shell 默认会对仅包含单个 ShellContent 的 FlyoutItem 做"扁平化"处理：直接将该页面作为导航根，不在侧边栏（Flyout）中显示对应的标签项。当添加第二个 ShellContent 时，Shell 会保留 FlyoutItem 的层级结构，因此标签项能正常显示。

解决方法 #

给 FlyoutItem 添加 FlyoutDisplayOptions="AsMultipleItems" 属性，强制 Shell 即使在单个 ShellContent 的情况下也显示侧边栏标签项：

<FlyoutItem FlyoutDisplayOptions="AsMultipleItems">
    <ShellContent
        Title="Preferences"
        ContentTemplate="{DataTemplate views:PreferencesViewPage}"
        IsVisible="{Binding IsPreferencesIconFocused}"
        Route="Preferences" />
</FlyoutItem>

额外检查点 #

• 确认绑定的 IsPreferencesIconFocused 属性初始值为 true，如果初始为 false，即使配置正确也不会显示标签项
• 确保 PreferencesViewPage 已在项目中正确定义，且命名空间 views 已在XAML头部声明

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