.NET MAUI iOS端图片子文件夹资源加载异常问题

问题原因 #

iOS平台的资源打包机制和Android存在差异，默认不会自动识别Resources/Images目录下子文件夹中的图片资源，必须显式配置才能让iOS正确打包并加载这些资源。

解决步骤 #

1. 配置项目文件包含子目录图片 #

打开项目的.csproj文件，添加或修改ItemGroup节点，明确包含子目录下的图片文件：

<ItemGroup>
  <!-- 包含info_icons子目录下的所有SVG图片 -->
  <MauiImage Include="Resources\Images\info_icons\*.svg" />
  <!-- 若有其他格式图片，可添加对应规则 -->
  <!-- <MauiImage Include="Resources\Images\info_icons\*.png" /> -->
</ItemGroup>

该配置会让iOS打包时将子目录中的图片资源正确纳入资源包。

2. 确认SVG依赖包已安装 #

如果加载的是SVG格式图片，需确保项目已安装Microsoft.Maui.Graphics.Svg NuGet包，这是.NET MAUI加载SVG的必要依赖。

3. 验证路径与资源配置 #

• XAML中的路径写法保持不变（info_icons/next_left.svg），.NET MAUI会自动基于Resources/Images目录解析路径
• 右键图片文件→属性，确认生成操作已设置为MauiImage
• 清理并重建项目，避免缓存导致的资源未更新问题

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