.NET MAUI Shell：如何将ShellContent页面加入导航栈实现返回行为？

问题根源 #

Shell里同级的ShellContent，通过Flyout切换时是直接替换当前页面，不会把前一页加入导航栈。这就导致导航栈始终只有当前页面，PopAsync()和GoToAsync("..")自然无效，系统也不会自动显示返回按钮。

实现需求的三种方案 #

方案一：调整Shell层级结构（推荐） #

把OtherPage设为MainPage的下级页面，通过层级关系让Shell自动管理导航栈：

<ShellSection Title="Dashboard" Route="MainPage">
    <ShellContent ContentTemplate="{DataTemplate local:MainPage}" />
    <ShellContent Title="Ot" ContentTemplate="{DataTemplate local:OtherPage}" Route="OtherPage">
        <ShellContent.Icon>
            <FontImageSource Glyph="&#xe52f;" FontFamily="AwesomeSolid" Color="{AppThemeBinding Light={StaticResource Black}, Dark={StaticResource Gray100}}" />
        </ShellContent.Icon>
    </ShellContent>
</ShellSection>

这种方式下OtherPage会作为MainPage的标签页存在，若要保留Flyout切换逻辑，可选择下面的方案。

方案二：手动维护导航栈 #

保留原有Flyout结构，在导航时手动将MainPage加入栈中：

1. 在Shell的代码后台添加导航监听：

protected override async void OnNavigated(ShellNavigatedEventArgs args)
{
    base.OnNavigated(args);
    // 当跳转到OtherPage且栈中只有它时，把MainPage插入栈底
    if (args.Current.Location.OriginalString.Contains("OtherPage") && Shell.Current.Navigation.NavigationStack.Count == 1)
    {
        var mainPage = new MainPage();
        Shell.Current.Navigation.InsertPageBefore(mainPage, Shell.Current.Navigation.NavigationStack[0]);
    }
}

2. 或者在MainPage中触发导航时，指定导航模式：

// 比如在MainPage的按钮点击事件里跳转
await Shell.Current.GoToAsync("//OtherPage", true);

方案三：自定义返回按钮 #

如果不想调整结构，可在OtherPage里手动添加返回按钮并实现跳转逻辑：

<ContentPage.ToolbarItems>
    <ToolbarItem Text="返回" Clicked="BackButton_Clicked" />
</ContentPage.ToolbarItems>

代码后台实现返回：

private async void BackButton_Clicked(object sender, EventArgs e)
{
    await Shell.Current.GoToAsync("///MainPage");
}

效果验证 #

• 应用启动默认打开MainPage
• 通过Flyout切换到OtherPage后，导航栈会包含两个页面
• 点击返回按钮（系统自动显示或自定义按钮）可回到MainPage

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