Xamarin iOS转MAUI时Xaml解析报错，.csproj及CSC问题求助

问题概述 #

• XAML解析报错：Data at the root level is invalid; Line 1 position 1
• .csproj项目文件存在2个未定位的错误
• 出现2个CSC编译错误，无法追踪根源
• 已执行排查动作：验证所有XAML文件、检查.csproj XML有效性、删减项目文件缩小范围，均未解决问题

基于提供的.csproj片段的核心修正点 #

从你给出的项目片段来看，先优先修正以下配置问题：

1. OutputType配置错误：MAUI单项目的OutputType必须为Exe，而非Xamarin类库使用的Library，该错误会直接导致项目加载和编译异常，可能是XAML解析报错的核心诱因。
   修正代码：

   <OutputType>Exe</OutputType>
   

2. Sdk引用错误：MAUI项目需要使用专属的MAUI Sdk，当前片段使用的Microsoft.NET.Sdk不符合要求。
   修正代码：

   <Project Sdk="Microsoft.NET.Sdk.Maui">
   

3. 补充MAUI必备配置：检查是否缺失.NET 7 MAUI的版本及平台支持配置，示例补充内容：

   <PropertyGroup>
     <!-- 其他已有配置 -->
     <MauiVersion>7.0.86</MauiVersion> <!-- 匹配你的.NET 7安装版本 -->
     <SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'ios'">15.0</SupportedOSPlatformVersion>
     <SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'maccatalyst'">13.1</SupportedOSPlatformVersion>
   </PropertyGroup>
   

CSC编译错误排查方向 #

• 清理重建项目：执行dotnet clean清除缓存后，再运行dotnet build重新编译
• 检查命名空间迁移：Xamarin到MAUI的命名空间有变更，比如Xamarin.Forms需替换为Microsoft.Maui.Controls，排查代码中是否残留旧命名空间引用
• 开启详细编译日志：在Visual Studio中进入「工具->选项->项目和解决方案->构建并运行」，将MSBuild项目构建输出详细程度设为「详细」，从日志中定位CSC错误的具体文件和行号
• 验证资源配置：MAUI对图片、字体等资源的嵌入方式与Xamarin不同，检查.csproj中<MauiAsset>、<MauiImage>等资源标签配置是否正确

XAML解析错误补充排查 #

• 检查文件编码：确保所有XAML文件为UTF-8无BOM编码，BOM头会触发「根级别数据无效」的错误
• 验证XAML根节点：确认每个XAML文件的根节点是MAUI控件，且命名空间正确，示例：

  <?xml version="1.0" encoding="utf-8" ?>
  <ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
               xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
               x:Class="YourAppNamespace.MainPage">
  </ContentPage>
  

• 排查合并资源字典：若项目中使用了合并的ResourceDictionary，检查是否存在重复定义或无效XAML语法

内容的提问来源于stack exchange，提问作者Steve H