.NET MAUI 通过监听窗口尺寸变化（OnSizeAllocated/WindowSizeChanged）响应屏幕旋转，结合VisualStateManager声明式适配或平台特定代码实现方向感知，核心是布局空间重构而非方向事件。
.NET MAUI 本身不提供直接的“设备方向变化事件”（如 iOS 的 viewWillTransition 或 Android 的 onConfigurationChanged），但它通过 窗口尺寸变更 + 设备信息 + 平台特定适配 实现对屏幕旋转和方向变化的可靠响应。关键不是监听“旋转”，而是监听“布局空间变化”，因为旋转通常会显著改变可用宽度、高度或纵横比。
监听窗口尺寸变化（最常用且跨平台）
这是 MAUI 中响应屏幕旋转的首选方式，适用于所有平台（Android/iOS/Windows）。系统在旋转后会触发窗口重绘，OnSizeAllocated 或 WindowSizeChanged 会被调用：
- 重写页面的
OnSizeAllocated(double width, double height)方法，在其中判断宽高关系或绝对尺寸 - 推荐搭配防抖处理，避免频繁触发导致 UI 闪烁或崩溃（尤其在折叠屏快速翻转时）
- 示例逻辑：
若width → 视为竖屏，加载紧凑单栏布局
若width > height→ 视为横屏，启用双列或侧边栏
使用 VisualStateManager 实现声明式方向适配
适合结构清晰、状态明确的 UI。你无需写 C# 判断逻辑，而是用 XAML 定义不同“视觉状态”，MAUI 自动匹配：
- 定义
VisualStateGroup，例如命名为OrientationStates - 添加
VisualState：一个叫Portrait（竖屏），一个叫Landscape（横屏） - 在每个状态中设置
Setter修改Grid.ColumnDefinitions、控件IsVisible、Rotation等属性 - MAUI 会根据当前
Width和Height自动切换状态（需配合VisualStateGroup.Setters中的条件表达式或自定义触发器）
平台特定补充：Android 和 iOS 的原生支持
当需要更精细控制（比如区分“自然横屏”和“强制横屏”、或响应系统级方向锁定），可借助平台代码：
-
Android：在
MainActivity中重写OnConfigurationChanged，获取newConfig.orientation，再通过MauiApplication.Current.MainPage通知页面 -
iOS：在
AppDelegate或SceneDelegate中监听Window.WindowScene?.InterfaceOrientation，用MainThread.BeginInvokeOnMainThread更新 UI - 注意：这些操作必须在主线程执行，否则会抛出异常或 UI 不更新
避免常见陷阱
旋转适配容易出问题，这几个点要特别留意：
- 不要在
OnSizeAllocated中反复 new 控件或重新绑定数据源——会导致内存泄漏和状态丢失 - 别依赖
DeviceInfo.Idiom判断方向（它只返回Phone/Tablet，不反映旋转） - 折叠屏设备旋转时可能同时触发“尺寸变化 + 折叠状态变化”，建议统一用
WindowSizeChanged事件做主入口，再结合FoldingFeature（Android）或ScreenMetrics做二次判断 - 测试时务必开启模拟器的“Extended Controls → Device Rotation”，手动拖动角度验证过渡是否平滑
基本上就这些。核心思路是：把“旋转”看作一种布局空间重构，用尺寸驱动 UI 变化，而不是等待某个“方向事件”。这样既稳定，又天然兼容折叠屏、分屏、悬停等多形态场景。
