OnPlatform 按操作系统（ios/android/windows/macos）适配，OnIdiom 按设备类型（Phone/Tablet/Desktop）适配；二者不可混用于同一属性，但可分层配合使用，覆盖80%跨平台ui适配需求。
OnPlatform 和 OnIdiom 是 .net MAUI 中处理跨平台 UI 差异最常用、最轻量的两个标记扩展，它们不依赖代码后台，纯 XAML 即可完成适配。关键区别在于：OnPlatform 按操作系统（iOS/Android/windows/macOS）区分，OnIdiom 按设备类型（Phone/Tablet/Desktop）区分。两者常配合使用，但不能混用同一个属性。
OnPlatform：按系统平台定制样式
适合解决因系统原生控件行为或默认样式不同带来的问题，比如 iOS 的安全区域偏移、Android 的输入法遮挡、Windows 的 DPI 缩放等。
- 支持简写语法：
{OnPlatform default=red, Android=Blue, iOS=Pink}，Default 可省略，未指定平台时自动回退到第一个值 - 复杂场景需显式声明类型：
- 可用平台名包括：
Android、iOS、Windows、macOS、Default（推荐始终保留 Default 作为兜底）
OnIdiom：按设备形态定制布局
适合响应式 UI 场景，比如手机竖屏只显示核心按钮，平板横屏加一列参数面板，桌面端展示完整表格和工具栏。
- 支持简写：
{OnIdiom Phone=200, Tablet=400, Desktop=800}，也支持Default回退 - 标准设备类型有：
Phone、Tablet、Desktop、TV、Watch（实际项目中主要用前三者） - 注意：MAUI 不会自动识别“大屏手机”或“小屏平板”，它依赖运行时
DeviceInfo.Idiom枚举值，该值由系统 API 返回，基本可靠
什么时候该用哪个？看实际需求
如果问题根源是“这个控件在 iOS 上顶部被刘海挡住”，选 OnPlatform；如果是“手机上折叠菜单，桌面端展开为侧边栏”，选 OnIdiom。
- 字体大小适配 → 多用 OnPlatform（各系统默认字号不同）
- margin/padding 布局留白 → OnPlatform + OnIdiom 都可能用，先试 OnIdiom（Phone/Tablet 差异明显）
- 按钮圆角、阴影强度 → OnPlatform（iOS 偏好柔和，Android 偏好明确边界）
- 导航结构（抽屉 vs 顶部 Tab）→ OnIdiom（本质是交互范式差异，不是系统差异）
可以嵌套或组合使用吗？
不能直接嵌套，但可以分层使用。例如：外层用 OnIdiom 控制整体布局结构，内部某个按钮的 Margin 再用 OnPlatform 微调对齐。
- 错误写法：
... - 正确思路：一个属性只用一种标记扩展；多个属性可分别用不同扩展
- 进阶替代：需要更复杂逻辑时，改用
Style+VisualStateManager或 MVVM 绑定DeviceInfo.Idiom和DeviceInfo.Platform
基本上就这些。不需要写平台判断代码，也不用维护多套 XAML，两个标记扩展覆盖了 80% 的日常适配需求。