WPF类库图片资源引用异常：运行应用时找不到资源

嘿，我之前也碰到过一模一样的情况——调试时图片显示正常，一运行应用就跳“Cannot find resource”的错误，折腾了好一会儿才搞定，给你分享几个靠谱的解决办法：

1. 确认Pack URI的正确性 #

你用的/Controls;component/Resources/image.png是绝对Pack URI，但这里有个容易踩的坑：类库的程序集名称必须和URI里的Controls完全一致（包括大小写）。如果你的类库项目名称是Controls但程序集名称被改成了别的（比如MyCompany.Controls），那这个URI就会直接失效。

更稳妥的方式是使用完整的Pack URI格式：

Source="pack://application:,,,/Controls;component/Resources/image.png"

另外，也可以试试相对路径（如果你的视图和Resources文件夹在类库项目里的层级关系固定），比如视图在Views文件夹、Resources在项目根目录，就用：

Source="../Resources/image.png"

2. 用资源字典统一管理图片资源 #

直接写URI容易踩路径坑，换成资源字典管理会稳定很多：

• 在类库的Resources文件夹里新建一个ImageResources.xaml文件，内容如下：

<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <BitmapImage x:Key="SampleImage" UriSource="image.png" />
</ResourceDictionary>

• 在你的“首个视图”的XAML里合并这个资源字典：

<UserControl.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="/Controls;component/Resources/ImageResources.xaml" />
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</UserControl.Resources>

• 然后Image控件直接引用资源：

<Image Source="{StaticResource SampleImage}" />

这种方式因为资源字典和图片在同一类库内，路径解析的容错性更高，不容易出问题。

3. 检查类库的引用和输出配置 #

• 如果应用是项目引用类库：确保类库的输出DLL已经被复制到应用的输出目录（右键应用项目→属性→引用→检查类库的“复制本地”是否为True）。
• 如果是通过NuGet包引用类库：要确保NuGet打包时包含了Resource类型的文件。可以在类库的.csproj里添加配置：

<ItemGroup>
    <Resource Include="Resources\*.png" />
</ItemGroup>

避免打包时漏掉资源文件。

4. 排查运行时资源加载问题 #

如果还是找不到，可以在代码里加个调试片段，看看资源到底能不能被加载：

try
{
    var uri = new Uri("/Controls;component/Resources/image.png", UriKind.Relative);
    var streamInfo = Application.GetResourceStream(uri);
    if (streamInfo == null)
    {
        MessageBox.Show("资源加载失败，检查URI和程序集名称");
    }
}
catch (Exception ex)
{
    MessageBox.Show($"加载异常：{ex.Message}");
}

通过这个可以定位到底是URI写错了，还是程序集没被正确加载。

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