maui首次启动引导页通过preferences记录状态、carouselview实现滑动、onappearing或onstart中安全导航三步实现：用preferences.set/get控制展示逻辑，carouselview绑定数据并配indicatorview，避开构造函数导航陷阱。
MAUI首次启动引导页的核心思路
MAUI本身不内置“首次启动引导页”（Onboarding）组件，但你可以用纯XAML页面 + 本地存储判断 + 导航控制三步实现。关键不是做多炫的动画，而是准确识别“是不是第一次打开”，并只在首次跳转到引导页。
1. 用Preferences记录是否已展示过引导页
MAUI推荐用Microsoft.Maui.Storage.Preferences存一个布尔值，轻量、跨平台、无需额外依赖：
- 在App.xaml.cs的
OnStart()或主页面OnAppearing()中读取Preferences.Get("has_seen_onboarding", false) - 如果返回
false，就导航到你的引导页（比如Navigation.PushAsync(new OnboardingPage())） - 用户看完引导页后，在最后一页的“开始体验”按钮里写：
Preferences.Set("has_seen_onboarding", true)
2. 引导页建议用CarouselView实现滑动效果
不用第三方库，MAUI原生CarouselView就能做流畅翻页：
- 绑定一个
List<onboardingitem></onboardingitem>数据源，每项含标题、描述、图片路径 - 用
IndicatorView加底部小圆点，设置CarouselView.IndicatorView关联即可 - 禁用左右滑动手势？可以设
IsSwipeEnabled="False"，改用底部“下一步”按钮控制CurrentItem
3. 首次启动逻辑要避开冷启动陷阱
别在App.xaml.cs构造函数里判断——此时Application.Current.MainPage可能还没初始化，导航会失败：
- 推荐在
MainPage.xaml.cs的OnAppearing()里检查并跳转（确保页面已加载） - 如果想更早拦截（比如启动即显示引导页），可在
App.xaml.cs的OnStart()里设置MainPage = new NavigationPage(new OnboardingPage())，但记得之后再切回正常首页 -
安卓上注意：按返回键退出引导页时，应直接退出App，而不是返回空白页——可在
OnboardingPage重写OnBackButtonPressed()并返回true
基本上就这些。不复杂但容易忽略的是存储时机和导航上下文——只要Preferences写对位置、导航调用在页面就绪后，引导页就稳了。
