Xamarin.Forms图片配置正确仍无法显示的问题排查与解决

我在Xamarin.Forms应用中遇到图片无法显示的问题，已确认将图片标记为嵌入资源，文件路径与命名空间也核对正确，但控制台输出显示图片未找到，图片依然无法显示。以下是简化后的代码：

XAML 代码 #

<ScrollView Orientation="Horizontal">
    <StackLayout x:Name="menuStack1" Orientation="Horizontal">
    </StackLayout>
</ScrollView>

C# 后台代码 #

public MainPage()
{
    InitializeComponent();
    Add();
}

private void Add()
{
    var image = new Image
    {
        Source = "YourNamespace.icon.png", // 替换为项目实际命名空间
        Aspect = Aspect.AspectFit,
        HeightRequest = 50,
        WidthRequest = 50,
        AutomationId = "i"
    };

    // 检查图片是否存在
    Console.WriteLine($"Image file exists: {ImageSource.FromResource("YourNamespace.icon.png") != null}");

    image.GestureRecognizers.Add(new TapGestureRecognizer { Command = new Command(() => Image_Tapped()) });
    menuStack1.Children.Add(image);
}

private void Image_Tapped()
{
    DisplayAlert("Image Tapped", "Image tapped", "OK");
}

可能的原因及排查解决步骤 #

1. 嵌入资源命名格式错误

   • 若图片放在子文件夹中，资源完整名称需包含文件夹路径，格式为命名空间.文件夹名.文件名。比如图片在Resources/Icons目录下，资源名称应为YourNamespace.Resources.Icons.icon.png。
   • 可打开项目的.csproj文件，查看对应图片的<EmbeddedResource>节点的LogicalName属性，该值即为正确的资源名称。

2. 大小写不匹配

   • .NET嵌入资源名称区分大小写，需确保代码中的名称与实际资源（文件名、文件夹名）的大小写完全一致，比如实际文件是Icon.png，代码写成icon.png会导致找不到资源。

3. 资源标记不规范

   • 右键图片文件→属性，确认「生成操作」为「嵌入的资源」，「复制到输出目录」设置为「不复制」（嵌入资源会打包进程序集，无需复制）。
   • 检查.csproj文件，确认图片对应的条目是<EmbeddedResource Include="icon.png" />（子文件夹会对应路径），而非<Content>或其他类型。

4. 跨程序集资源加载问题

   • 若图片在其他类库项目中，需明确指定资源所在程序集，使用ImageSource.FromResource("资源名称", typeof(类库中任意类).Assembly)来加载。

5. 拼写错误

   • 仔细核对命名空间、文件夹名、文件名的拼写，包括点号的位置，避免多写或漏写。

额外验证步骤 #

• 输出当前程序集所有嵌入资源列表，直接确认目标图片的完整名称：

var resources = System.Reflection.Assembly.GetExecutingAssembly().GetManifestResourceNames();
foreach (var res in resources)
{
    Console.WriteLine("Resource: " + res);
}

• 若图片在类库中，将GetExecutingAssembly()替换为typeof(类库中的类).Assembly即可获取对应程序集的资源列表。

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