如何在MAUI中替换页面、设置新根页面或移除导航栈根页面？

问题背景 #

MAUI应用启动默认显示登录页面，登录完成跳转至仪表盘页面后，用户仍可通过返回按钮回到登录页。希望实现跳转后关闭登录页，让仪表盘成为根页面（类似Android中在仪表盘Activity调用登录页finish()的效果），并明确三个问题：

1. 是否可以将一个页面替换为另一个页面？
2. 是否可以将某页面设为新的根页面？
3. 是否可以从navigation stack中移除根页面？

问题解答与实现方案 #

1. 是否可以将一个页面替换为另一个页面？

可以。通过修改导航栈内容或直接替换应用根页面的方式，都能实现页面替换。

2. 是否可以将某页面设为新的根页面？

可以。有两种常用实现方式：直接重新设置Application.Current.MainPage，或操作导航栈将目标页面设为栈底元素。

3. 是否可以从navigation stack中移除根页面？

可以。通过访问Navigation.NavigationStack集合，移除指定的根页面元素即可。

具体代码实现 #

场景1：普通导航（非Shell架构）

应用启动时设置根页面为包含登录页的导航页：

public App()
{
    InitializeComponent();
    MainPage = new NavigationPage(new LoginPage());
}

登录成功后，在LoginPage的登录逻辑中执行以下操作：

方式一：直接替换根页面（推荐）

这种方式完全替换原有导航栈，最简洁高效：

// 登录验证通过后
Application.Current.MainPage = new NavigationPage(new DashboardPage());

方式二：操作导航栈移除登录页

适合需要保留部分导航历史的场景：

// 登录验证通过后
var dashboardPage = new DashboardPage();
// 获取当前导航栈的所有页面
var existingPages = Navigation.NavigationStack.ToList();
// 移除栈中所有页面（这里仅需移除登录页）
foreach (var page in existingPages)
{
    Navigation.RemovePage(page);
}
// 将仪表盘页面推入作为新的根页面
await Navigation.PushAsync(dashboardPage);

场景2：MAUI Shell架构

如果应用使用Shell，可通过路由导航并清除登录页栈：

// 登录验证通过后
// 导航到仪表盘的Shell路由（需提前在Shell中注册路由）
await Shell.Current.GoToAsync("//Dashboard");
// 清除登录页所在的导航栈
Shell.Current.Navigation.NavigationStack.Clear();

或者启动时根据登录状态直接设置根页面：

public App()
{
    InitializeComponent();
    // 模拟判断用户是否已登录
    if (!IsUserLoggedIn())
    {
        MainPage = new LoginPage();
    }
    else
    {
        MainPage = new AppShell();
    }
}

// 登录成功后调用该方法切换根页面
private void OnLoginSuccess()
{
    MainPage = new AppShell();
}

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