Xamarin.Forms开发ImageButton时Image.png加载失败问题求助

问题现象 #

在安卓平板上运行应用时，加载页面出现以下错误日志：

[0:] Could not load image named: {0}: Image.png
[0:] FileImageSourceHandler: Could not find image or image file was invalid: File: Image.png

对应的XAML代码：

<ImageButton  x:Name="Button" Grid.Row="44" Grid.Column="19" Grid.RowSpan="6" Grid.ColumnSpan="18" HorizontalOptions="CenterAndExpand" VerticalOptions="Center" Source="Image.png" Clicked="Button_Clicked" BackgroundColor="Transparent"  />

图片Image.png位于./Media目录，XAML文件在./Page.xaml。删除图片时应用无法启动（提示找不到图片），但图片存在时应用可启动，仅加载页面时报错。已尝试将图片生成操作设为Resource、放入Android项目drawable目录并设为AndroidResource，问题仍未解决。

解决方案 #

1. 修正图片路径引用 #

由于图片存放在./Media子目录，XAML中直接写Image.png会导致路径匹配错误，需要指定完整相对路径：

Source="Media/Image.png"

如果是嵌入式资源，也可以使用命名空间前缀的写法（替换你的项目命名空间为实际项目根命名空间，可在项目属性中查看）：

Source="Resource://你的项目命名空间.Media.Image.png"

2. 确认图片生成操作设置 #

• 共享项目中的图片：右键图片文件→属性，将生成操作设为Embedded resource，同时把复制到输出目录设置为如果较新则复制或始终复制。
• Android项目中的图片：放入Resources/drawable目录后，右键图片→属性，生成操作设为AndroidResource，同时注意图片文件名必须为小写字母+下划线格式（不能包含大写字母或空格），比如将Image.png改为image.png，然后XAML中引用Source="image.png"。

3. 清理并重建项目 #

执行以下步骤清除缓存并重新构建：

• 右键解决方案→清理解决方案
• 删除项目目录下的bin和obj文件夹
• 右键解决方案→重新生成解决方案
• 卸载安卓设备/模拟器上的旧应用后重新部署

4. 检查图片文件有效性 #

• 确认Image.png未损坏，可尝试用图片编辑器重新保存一次
• 确保图片格式为安卓支持的类型（如PNG、JPG，避免使用WebP等非标准格式）

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