You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

MAUI应用中使图片可用,除MauiImage外还需配置哪些文件?

MAUI图片资源无法正常使用的排查步骤
  • 确认项目文件(*.csproj)中的图片配置
    确保图片的<MauiImage>条目路径、属性配置正确,示例:

    <MauiImage Include="Resources\Images\your-new-image.png" />
    

    注意路径要和实际文件位置完全匹配,部分平台(如Android/iOS)对文件名大小写敏感。

  • 清理并重建项目
    .vsidx类文件是Visual Studio自动生成的临时索引文件,手动修改无效。直接右键解决方案选择清理,再执行重建,让VS重新生成所有资源索引文件。

  • 检查文件属性设置
    在VS中右键目标图片文件→属性,确认「生成操作」为MauiImage,「复制到输出目录」设置为「如果较新则复制」或「始终复制」。

  • 排查平台特定问题

    • Android:检查Resources\drawable目录下是否生成了对应分辨率的自动缩放图片,若需自定义分辨率,要在csproj中添加BaseSize属性配置。
    • iOS:确认图片被正确打包到Assets.xcassets中,必要时可手动删除该目录后重新构建。
  • 删除缓存与临时文件
    手动清理以下目录后再重新构建:

    • 项目根目录下的bin和obj文件夹
    • VS临时缓存:%LOCALAPPDATA%\Microsoft\VisualStudio\<版本号>\ComponentModelCache
    • 模拟器/真机上的应用缓存,或直接卸载重装应用
  • 验证资源引用逻辑
    代码中引用图片的名称需准确:

    • XAML中直接使用文件名(无需后缀):Source="new-image"
    • C#代码中使用全命名空间引用:ImageSource.FromResource("YourAppName.Resources.Images.new-image.png")

内容的提问来源于stack exchange,提问作者Marc George

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.11 12:02:07