用途：指导将 Xamarin.Forms 应用迁移到 .NET MAUI 的工作流技能，涵盖项目结构决策、SDK 风格项目转换、命名空间重命名等内容。参考资料见 references/forms-migration-api.md（含项目模板、命名空间表、API 弃用表与参考代码）。
主要流程：新建 .NET MAUI 单项目（多项目会引发 AOT/构建错误），把跨平台代码与平台代码复制到 Platforms/<platform>/，更新 XAML/C#/Essentials 命名空间，修复布局行为变化，将渲染器迁移为处理器（不要用 shimmed renderers），将 Effects 迁移为 Behaviors，移除 Microsoft.Maui.Controls.Compatibility 包，更新 NuGet 依赖与应用数据存储，删除 bin/obj/Resource.designer.cs 后迭代构建测试，并对照 .NET 10 弃用 API 列表验证。策略是新建项目并复制代码，不要就地编辑旧项目文件。
关键限制与陷阱：MAUI 默认 Spacing 为 0（Xamarin.Forms 为 6），布局可能静默错乱，应显式指定布局值或用隐式样式；*AndExpand 已废弃且无警告，需改为 Grid 星号尺寸；StackLayout 内的 ScrollView 不会滚动；Grid 行列须显式声明；Frame 改用 Border 的 StrokeShape；BoxView 默认 0×0；RelativeLayout 改用 Grid。Effects 现为 Behaviors，需重新设计。兼容包会导致连锁不兼容，必须移除。App Center 与 Visual Studio for Mac 已退役。Android 迁移难度高于 iOS，OEM 渲染差异需真机测试，阴影与主题切换需在平台处理器代码中处理。
适用场景：正在执行 Xamarin.Forms 到 .NET MAUI 迁移的开发者，用于按步骤排查构建与布局问题。
限制：文档未提供安装命令、收费方式与价格信息，暂无相关内容可说明。