.NET MAUI中.svg/.xml格式图片在iOS设备无法正常显示问题

问题复现路径 #

• 将img1.svg、img2.xml等不同格式的图片资源添加到项目的Resources/Images目录
• 在XAML页面添加图片引用代码：

  <Image Source="img1.svg" />
  

• 部署到iOS设备运行后，对应格式图片无法正常加载显示，Android等其他平台无此问题。

根因与修复方案 #

1. 资源生成操作配置错误 #

MAUI 对多平台图片资源的统一处理依赖MauiImage生成操作，手动修改为其他类型会导致iOS端无法识别矢量资源：

• 右键点击目标图片文件打开属性面板，将所有平台的「生成操作」统一设置为MauiImage，不要单独给iOS平台设置差异化的生成规则。

2. 矢量图引用方式不符合iOS平台规则 #

iOS平台资源加载严格区分大小写，且MAUI打包iOS矢量资源时会自动剔除扩展名，带后缀引用会匹配不到资源：

• 统一将图片文件名修改为全小写、无空格、无特殊字符的格式，避免大小写不匹配问题
• XAML/C#中引用矢量图时去掉文件扩展名，参考正确写法：

  <!-- 错误：带.svg后缀，iOS端无法命中资源 -->
  <Image Source="img1.svg" />
  
  <!-- 正确：仅使用文件名主名引用 -->
  <Image Source="img1" />
  

3. .xml矢量图格式不兼容 #

.xml格式的矢量图是Android平台专属的VectorDrawable格式，iOS原生不支持该格式的直接解析：

• 将现有.xml矢量图转换为标准.svg格式后重新放入资源目录，按照前两项规则配置即可正常加载，无需额外编写平台适配代码。

4. 构建缓存导致的资源不更新 #

配置修改后如果仍存在加载异常，是旧构建缓存残留导致：

• 关闭Visual Studio，删除项目根目录下的bin、obj文件夹
• 清理连接的Mac构建主机上的对应项目缓存，重新生成部署即可。

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