WPF如何通过代码修改Image控件Source，图片加载失败怎么排查解决

排查步骤 #

• 第一步：检查图片资源的生成操作配置
  右键项目中graphics文件夹下的所有图片文件，选择「属性」，确保：
  • 「生成操作」设置为Resource
  • 「复制到输出目录」设置为「不复制」（资源会直接嵌入程序集，不需要单独输出）
• 第二步：排查路径格式问题
  相对Uri在WPF中容易受上下文影响加载失败，建议替换为标准WPF Pack URI绝对路径，格式为：
  pack://application:,,,/[你的程序集名称];component/[资源相对路径]
  其中[你的程序集名称]替换为你项目实际的程序集名（可右键项目→属性→应用程序页查看）
• 第三步：添加错误日志定位问题
  WPF图片加载失败默认不会抛出全局异常，可以监听两个事件捕获具体错误原因：
  • BitmapImage.DecodeFailed：图片解码阶段报错
  • Image.ImageFailed：Image控件加载资源阶段报错
• 第四步：检查Image控件布局属性
  你看到的细灰线大概率是Image控件没有拿到图片尺寸，自动收缩导致的，可以先手动给FixerImg设置固定宽高（如64x64）、Stretch属性设为Uniform测试。

修复后代码示例 #

public FixerBox(Dictionary<string,string> deets)
{
    InitializeComponent();
    btnOff();
    this.FixerTitle.Text = deets["Title"];
    this.FixerDesc.Text = deets["Description"];
    this.FixerTags.Text = deets["Tags"];
    
    // 先固定Image控件尺寸避免布局收缩
    FixerImg.Width = 64;
    FixerImg.Height = 64;
    FixerImg.Stretch = Stretch.Uniform;

    try
    {
        // 替换下方的「你的项目程序集名」为实际值
        string fullPackUri = $"pack://application:,,,/你的项目程序集名;component{deets["Img"]}";
        var bitmap = new BitmapImage(new Uri(fullPackUri, UriKind.Absolute));
        // 监听解码错误
        bitmap.DecodeFailed += (s, e) =>
        {
            System.Diagnostics.Debug.WriteLine($"图片解码失败：{e.ErrorException.Message}");
        };
        this.FixerImg.Source = bitmap;
    }
    catch (Exception ex)
    {
        System.Diagnostics.Debug.WriteLine($"图片资源加载失败：{ex.Message}");
    }

    // 监听控件加载错误
    this.FixerImg.ImageFailed += (s, e) =>
    {
        System.Diagnostics.Debug.WriteLine($"Image控件加载失败：{e.ErrorException.Message}");
    };
}

额外检查项 #

• 确认graphics文件夹名称、图片文件名和路径中的拼写完全一致
• 如果自定义控件是写在单独的类库项目中，Pack URI中的程序集名需要替换为类库的程序集名
• 运行程序后查看Visual Studio的「输出」窗口，即可看到上述代码打印的具体错误信息，根据错误提示调整即可。

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