.NET MAUI Shell应用中如何实现主从（明细）结构导航

你查阅文档看到的官方警告原文如下：

Warning
NavigationPage is incompatible with .NET MAUI Shell apps, and an exception will be thrown if you attempt to use NavigationPage in a Shell app. For more information about Shell apps, see Shell.

这个警告存在明确的适用边界，它仅禁止两种错误用法：一是将整个Shell应用实例包裹在NavigationPage中作为应用根页面，二是在Shell的导航流程中强行嵌入独立NavigationPage实例作为导航容器。Shell本身内置了完整的层级导航栈能力，完全可以原生支持列表页跳详情页、编辑完成返回的主从交互，不需要重写整套Shell导航逻辑。

具体实现步骤 #

• 注册层级页面路由
  Shell会自动为Flyout菜单、底部Tab栏配置的根页面注册路由，列表页跳转的详情页属于非根层级页面，需要提前手动注册路由。在AppShell.xaml.cs的构造函数中添加如下代码即可：

  public AppShell()
  {
      InitializeComponent();
      // 注册详情页路由
      Routing.RegisterRoute(nameof(ItemDetailPage), typeof(ItemDetailPage));
  }
  

• 列表页触发导航
  为CollectionView绑定选中事件/选中命令，调用Shell原生导航方法传入目标页和需要传递的明细参数：

  // 列表页ViewModel中绑定的列表项选中命令
  async Task NavigateToDetail(ItemModel selectedItem)
  {
      if (selectedItem == null) return;
      
      // 带参数导航到详情页，Shell会自动维护导航栈、添加导航栏返回按钮
      await Shell.Current.GoToAsync(nameof(ItemDetailPage), new Dictionary<string, object>
      {
          [nameof(ItemDetailViewModel.ReceivedItem)] = selectedItem
      });
  
      // 重置选中状态，避免返回列表页时重复触发导航
      SelectedListItem = null;
  }
  

• 详情页接收参数、处理返回
  给详情页对应的ViewModel添加查询参数特性，接收列表页传递的条目数据，编辑完成后调用Shell导航的返回语法即可回到列表页，系统返回手势、导航栏返回按钮默认就能正常工作，不需要额外实现：

  // 详情页ViewModel
  [QueryProperty(nameof(ReceivedItem), nameof(ReceivedItem))]
  public partial class ItemDetailViewModel : ObservableObject
  {
      [ObservableProperty]
      ItemModel receivedItem;
  
      [RelayCommand]
      async Task SaveChangesAndReturn()
      {
          // 执行数据保存、校验逻辑
          await AppDataContext.SaveChangesAsync();
          // ".." 代表返回导航栈上一页，和文件系统路径语法一致
          await Shell.Current.GoToAsync("..");
      }
  }
  

补充说明 #

• 如果需要自定义详情页导航栏样式，直接在详情页XAML上设置Shell提供的附加属性即可，比如Shell.NavBarIsVisible="False"隐藏导航栏、Shell.Title="明细编辑"设置导航栏标题，和传统NavigationPage的使用体验一致。
• 你提到的早在1985年低配置设备上用dBase II就能实现的主从交互，属于MAUI Shell原生支持的基础场景，只是官方文档的警告没有明确说明适用边界，才会造成Shell不支持层级导航的误解。整个实现过程不需要修改Shell默认架构，也不需要引入第三方导航组件，几行原生代码就能满足需求。

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