.NET Maui中Shell.TitleView遮挡NavigationPage标签及导航栈重复实例问题

一、解决AppShell按钮遮挡MainPage标签页的问题 #

1. 调整TitleView布局高度 #

你当前TitleView里的按钮设置了MaximumHeightRequest="75"，高度过大导致挤压下方TabbedPage的标签栏空间。建议降低按钮高度，同时给容器Grid设置明确的高度限制：

<Shell.TitleView>
    <Grid ColumnDefinitions="*, Auto" HeightRequest="50"> <!-- 新增固定高度 -->
        <HorizontalStackLayout Grid.Column="1" VerticalOptions="Center">
            <Button Text="User Info"
                    FontSize="Micro"
                    VerticalOptions="Center"
                    ImageSource="icon_user.png"
                    MaximumHeightRequest="40" <!-- 降低按钮高度 -->
                    ContentLayout="left,1"
                    Clicked="User_Info_Button_Clicked"/>
            <!-- 其他按钮同步修改MaximumHeightRequest为40 -->
        </HorizontalStackLayout>
    </Grid>
</Shell.TitleView>

2. 给TabbedPage设置顶部内边距 #

在MainPage（TabbedPage）的XAML中，针对不同平台设置顶部内边距，避开TitleView的高度：

<TabbedPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
            xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
            x:Class="YourNamespace.MainPage"
            Padding="0,{OnPlatform Android=50, iOS=44}"> <!-- 根据平台适配顶部边距 -->
    <!-- Log Page和Reporting Page标签项 -->
</TabbedPage>

3. 优化Shell的TabBar偏移配置 #

如果上述方法仍有遮挡，可在AppShell中设置TabBar的垂直偏移：

<Shell xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
       xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
       x:Class="YourNamespace.AppShell"
       TabBarVerticalOffset="50"> <!-- 偏移量对应TitleView的高度 -->
    <!-- ShellContent及其他配置 -->
</Shell>

二、解决导航栈重复添加MainPage实例的问题 #

1. 将MainPage设为Shell的根页面 #

确保AppShell直接绑定MainPage作为根，避免动态创建实例：

<ShellContent ContentTemplate="{DataTemplate local:MainPage}" 
              Route="MainPage"
              x:Name="ShellWindow"/>

2. 使用正确的返回方式，避免新建实例 #

不要用Shell.Current.GoToAsync(nameof(MainPage))或../{nameof(MainPage)}，这些都会创建新的MainPage实例，改用以下方式：

方式一：直接回到导航栈底部

// 在返回按钮点击事件中调用
await Shell.Current.Navigation.PopToRootAsync();

方式二：相对导航回到上一级（层级明确时）

如果是从一级子页面返回，直接用：

await Shell.Current.GoToAsync("..");

方式三：判断当前页面避免重复导航

在跳转逻辑中先判断是否已在MainPage，避免多余操作：

if (Shell.Current.CurrentPage is not MainPage)
{
    await Shell.Current.Navigation.PopToRootAsync();
}

3. 配置路由导航模式（可选） #

在AppShell构造函数中注册路由后，跳转时指定导航模式为Back，确保不会新建实例：

public AppShell()
{
    InitializeComponent();
    Routing.RegisterRoute(nameof(MainPage), typeof(MainPage));
}

// 跳转时使用
await Shell.Current.GoToAsync("//MainPage", new Dictionary<string, object>
{
    { "NavigationMode", NavigationMode.Back }
});

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