C#/XAML项目中Bitmap图片显示空白而非图像的问题排查

针对你遇到的WPF中图片显示空白（按钮正常）的问题，结合你的代码，给出以下排查和解决步骤：

1. 检查图片文件的项目部署设置 #

首先确认图片文件在项目中的属性配置：

• 选中图片文件，右键→属性
• 设置生成操作为「内容」
• 设置复制到输出目录为「如果较新则复制」或「始终复制」

WPF的相对路径是基于程序运行的输出目录（如bin/Debug），如果图片没有被复制到对应路径下，即使你认为路径正确，程序也找不到文件。

2. 监听BitmapImage加载错误，排查具体原因 #

BitmapImage默认加载失败不会抛出异常，所以你看不到错误信息。给BitmapImage添加DownloadFailed事件，直接输出错误详情：

// 替换原图片加载代码
Image image = new Image();
string imageFileName = Path.GetFileName(name) + ".png";
string relativePath = $"data/{mode.ToLower()}/individual/{imageFileName}";
Uri path = new Uri(relativePath, UriKind.RelativeOrAbsolute);

BitmapImage bitmap = new BitmapImage(path);
// 添加错误监听
bitmap.DownloadFailed += (sender, e) =>
{
    System.Diagnostics.Debug.WriteLine($"图片加载失败: {e.ErrorException.Message}");
    // 也可以在这里给image设置一个占位图，方便调试
    // image.Source = new BitmapImage(new Uri("placeholder.png", UriKind.Relative));
};

image.Source = bitmap;
image.Height = 90;
image.Width = 160;

运行程序后查看输出窗口，就能知道是文件不存在、格式错误还是权限问题。

3. 修正相对路径的解析方式 #

WPF中相对路径的解析有时候会因为上下文出现偏差，改用绝对路径构造可以避免这个问题：

string baseDir = AppDomain.CurrentDomain.BaseDirectory;
string fullPath = Path.Combine(baseDir, "data", mode.ToLower(), "individual", Path.GetFileName(name) + ".png");
Uri path = new Uri(fullPath, UriKind.Absolute);

这样直接基于程序启动目录构造绝对路径，不会出现相对路径解析错误。

4. 排查布局是否挤压/隐藏了图片 #

• 确认MakeRowDefinition(90)方法返回的是正确的行高：
  该方法应该返回new RowDefinition { Height = new GridLength(90) }，如果行高设置为Auto或者0，图片会被压缩或隐藏。
• 给图片所在的Grid添加临时边框，确认Grid是否正确渲染：

  grid.BorderBrush = Brushes.Red;
  grid.BorderThickness = new Thickness(1);
  

  如果能看到红色边框，说明Grid布局正常，问题出在图片加载；如果看不到边框，说明Grid本身没被正确布局。

5. 移除不必要的BeginInit/EndInit调用 #

代码中给Image调用BeginInit()和EndInit()是多余的——这两个方法主要用于XAML初始化或者批量设置属性的场景，代码逐个设置属性时不需要，移除后可能解决潜在的初始化冲突：

// 移除这两行代码
// image.BeginInit();
// image.EndInit();

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