.NET MAUI编译报错求助：MauiWinUIApplication未找到等问题

错误根源分析 #

1. XLS0414：未找到maui:MauiWinUIApplication #

• 核心原因是Windows平台App.xaml的命名空间引用缺失/错误，或Microsoft.Maui.Windows程序集未正确关联；也可能是项目文件中Windows目标的SDK引用异常。

2. CS1061：App不包含InitializeComponent定义 #

• 本质是XAML未生成对应的代码文件（.g.cs），常见触发点：
  • XAML与CS文件的命名空间、类名不匹配；
  • XAML的生成操作未设置为MSBuild:Compile；
  • XAML根元素的x:Class属性指向错误。

3. WMC9999/MSB4018：XamlCTask任务Xml异常 #

• 直接因App.xaml存在XML语法错误导致，比如标签未闭合、属性值未加引号、特殊字符未转义，或文件本身损坏。

具体解决步骤 #

步骤1：检查Windows平台App.xaml的核心结构 #

打开Platforms/Windows/App.xaml，确保内容符合标准模板：

<maui:MauiWinUIApplication
    x:Class="YourAppName.Platforms.Windows.App"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:maui="using:Microsoft.Maui">
</maui:MauiWinUIApplication>

• 确认xmlns:maui="using:Microsoft.Maui"命名空间引用存在；
• 保证x:Class属性值与App.xaml.cs中的命名空间+类名完全一致（例如YourAppName.Platforms.Windows.App）。

步骤2：验证App.xaml.cs的代码结构 #

检查Platforms/Windows/App.xaml.cs，确保以下要求满足：

namespace YourAppName.Platforms.Windows;

public partial class App : MauiWinUIApplication
{
    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();
}

• 类必须标记为partial class；
• 确保继承自MauiWinUIApplication，且命名空间与XAML的x:Class完全匹配。

步骤3：检查项目文件（.csproj）的Windows配置 #

打开项目文件，确认Windows目标的关键配置完整：

<PropertyGroup Condition="'$(TargetFramework)' == 'net8.0-windows10.0.19041.0'">
    <UseMaui>true</UseMaui>
    <SingleProject>true</SingleProject>
    <WindowsPackageType>MSIX</WindowsPackageType>
</PropertyGroup>

<ItemGroup Condition="'$(TargetFramework)' == 'net8.0-windows10.0.19041.0'">
    <PackageReference Include="Microsoft.Maui.Windows" Version="$(MauiVersion)" />
</ItemGroup>

• 确保Microsoft.Maui.Windows包引用存在，且版本与其他MAUI包一致；
• 确认UseMaui设置为true。

步骤4：修复XAML的XML语法错误 #

针对WMC9999错误，逐行检查App.xaml：

• 所有标签必须正确闭合（如<maui:MauiWinUIApplication>对应</maui:MauiWinUIApplication>）；
• 属性值必须用双引号包裹；
• 特殊字符需转义（如&要写成&）；
• 若文件损坏，可从备份恢复，或新建干净的Windows平台App.xaml替换原文件。

步骤5：彻底清理并重建项目 #

执行以下操作（比单纯删除bin/obj更彻底）：

1. 在Visual Studio中点击Build -> Clean Solution；
2. 删除项目根目录下的.vs隐藏文件夹；
3. 重启Visual Studio；
4. 点击Build -> Rebuild Solution。

内容的提问来源于stack exchange，提问作者r-m85