.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 变化，而不是等待某个“方向事件”。这样既稳定，又天然兼容折叠屏、分屏、悬停等多形态场景。