.NET MAUI项目加载后出现多类错误，求技术解决方案

核心排查前提 #

先确认你的Visual Studio版本为2022 17.4+，且已完整安装.NET MAUI工作负载（打开VS安装器，检查「移动开发.NET」工作负载，确保Android、iOS等关联组件未缺失）。

逐个错误解决步骤 #

1. MSB4018：NuGet回退文件夹不存在 #

该问题是引发后续一系列错误的核心原因，会导致NuGet包解析失败：

• 手动创建缺失的文件夹：D:\Program Files (x86)\Microsoft Visual Studio\Shared\NuGetPackages
• 打开VS的「工具 > NuGet包管理器 > 包管理器设置」，在「NuGet包管理器 > 程序包源」中：
  • 确认「Microsoft Visual Studio Offline Packages」源的路径指向刚创建的文件夹，路径错误则修改；若无需离线包，可直接删除该源
• 以管理员身份打开命令提示符，执行缓存重置命令：

  nuget locals all -clear
  

2. XA1018：AndroidManifest.xml不存在 #

初始项目的清单文件默认位于Platforms/Android/AndroidManifest.xml，缺失则按以下步骤处理：

• 右键项目 > 添加 > 新建项，选择「Android Manifest」，放置在Platforms/Android目录下，使用默认模板内容：

  <?xml version="1.0" encoding="utf-8"?>
  <manifest xmlns:android="http://schemas.android.com/apk/res/android">
      <application android:allowBackup="true" android:icon="@mipmap/appicon" android:roundIcon="@mipmap/appicon_round" android:supportsRtl="true"></application>
      <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
      <uses-permission android:name="android.permission.INTERNET" />
  </manifest>
  

• 右键项目 > 编辑项目文件，确认包含以下配置：

  <ItemGroup Condition="'$(TargetFramework)' == 'net7.0-android'">
    <AndroidManifest Include="Platforms\Android\AndroidManifest.xml" />
  </ItemGroup>
  

3. XLS0414/CS系列错误：控件、命名空间未找到 #

这类错误均由NuGet包未正确加载导致：

• 编辑项目文件（.csproj），确认顶部MAUI SDK引用正确，初始项目应包含：

  <Project Sdk="Microsoft.NET.Sdk">
    <PropertyGroup>
      <TargetFrameworks>net7.0-android;net7.0-ios;net7.0-maccatalyst</TargetFrameworks>
      <TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net7.0-windows10.0.19041.0</TargetFrameworks>
      <OutputType>Exe</OutputType>
      <RootNamespace>MauiApp1</RootNamespace>
      <UseMaui>true</UseMaui>
      <SingleProject>true</SingleProject>
      <ImplicitUsings>enable</ImplicitUsings>
    </PropertyGroup>
  

• 右键项目 > 管理NuGet程序包，确认Microsoft.Maui.Controls、Microsoft.Maui.Controls.Compatibility、Microsoft.Extensions.DependencyInjection等包已安装，版本与项目.NET版本匹配（如.NET 7对应7.x版本）
• 执行「生成 > 清理解决方案」，删除项目目录下的bin和obj文件夹，重新生成解决方案

终极兜底方案 #

若以上步骤均无效，直接重建项目：

1. 关闭所有VS窗口，打开VS安装器，修复.NET MAUI工作负载
2. 重新打开VS，选择「创建新项目」，选择「.NET MAUI App」，保留默认配置完成创建
3. 直接运行新项目，若正常则对比新项目与现有项目的配置差异（项目文件、NuGet包、目录结构等）

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