MAUI中MainPage外多NavigationPage独立导航实现问题

你的核心问题是错误使用了TemplatedPage的ControlTemplate属性来承载NavigationPage的内容——ControlTemplate是用于定义控件的可视化结构模板，并非用来直接显示Page类型的内容，这就是NavRoot页面没渲染出来的原因。

正确实现方式 #

要在一个ContentPage内部嵌入独立的NavigationPage，你需要直接将NavigationPage作为ContentPage的子元素（通过Content属性或布局容器），而非ControlTemplate。

保持ViewModel代码不变 #

public NavTestVM()
{
    NavPage = new NavigationPage(new NavRoot());
}

修正后的XAML代码 #

可以通过ContentView直接承载NavigationPage：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MauiAndUnitTest.Views.NavTest"
             x:DataType="viewModels:NavTestVM">
    <ContentView Content="{Binding NavPage}" HeightRequest="400" WidthRequest="600" />
</ContentPage>

也可以直接将NavigationPage设为父页面的Content：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MauiAndUnitTest.Views.NavTest"
             x:DataType="viewModels:NavTestVM">
    <ContentPage.Content>
        {Binding NavPage}
    </ContentPage.Content>
</ContentPage>

在MainPage之外使用NavigationPage的关键注意事项 #

• 不要用ControlTemplate承载Page：ControlTemplate是自定义控件的模板系统，Page类型内容必须通过ContentPresenter、ContentView的Content属性，或直接作为父页面Content来渲染。
• 确保生命周期正确绑定：NavigationPage作为子元素嵌入时，需保证其Parent属性关联到父页面，这样MAUI的页面生命周期事件（如OnAppearing）才能正常触发。
• 导航状态完全隔离：每个NavigationPage实例会维护独立的导航栈，多个实例的导航操作互不干扰，正好匹配你需要的多独立层级需求。
• 避免过度嵌套：MAUI支持嵌套NavigationPage，但过多嵌套可能导致导航栏重叠、生命周期混乱，建议每个独立层级仅保留一个NavigationPage实例。
• 模态页归属层级：在独立层级中打开模态页时，要调用对应NavigationPage实例的PushModalAsync()方法，而非父页面的方法，确保模态页归属于当前层级的导航栈。

多独立导航层级的复用方案 #

你可以直接复用该模式：在ViewModel中创建三个NavigationPage实例，分别绑定到页面中的三个ContentView（或布局容器），每个NavigationPage维护自己的导航栈，即可实现完全独立的多层级导航。

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