WPF程序添加ImageSource资源后出现‘MarkupExtension is not valid for Setter.Value’设计时错误但运行正常

我之前在VS2019开发WPF项目时也碰到过这个诡异的设计器bug——明明运行完全正常，设计器却硬报错误，还得反复改资源名临时解决，太折腾人了。下面给你拆解问题根源和几个一劳永逸的解决办法：

问题本质 #

这是Visual Studio 2019（16.8.x版本）XAML设计器的已知解析bug：当<Application.Resources>中同时存在ImageSource这类非控件/样式资源，并且有通过StaticResource引用字体的Setter时，设计器会混乱地判定StaticResource标记扩展不符合Setter.Value的要求，完全是设计器的逻辑错误，和代码本身无关。

靠谱的解决方案（按优先级排序） #

1. 替换StaticResource为DynamicResource（最简单） #

直接把字体引用改成DynamicResource，设计器就能正确识别这个标记扩展类型，错误立刻消失：

<Setter Property="FontFamily" Value="{DynamicResource NotoBold}" />

不用担心性能问题，字体资源在运行时只会被解析一次，和StaticResource几乎没有区别。

2. 拆分资源到独立的ResourceDictionary #

把字体资源和图片资源分开存到不同的ResourceDictionary文件里，再合并到全局资源中，通过资源隔离避免设计器的解析冲突：

• 新建FontResources.xaml：

<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <FontFamily x:Key="NotoBold"> fonts/NotoSerifCJKtc-Bold.otf#Noto Serif CJK TC Bold </FontFamily>
</ResourceDictionary>

• 新建ImageResources.xaml：

<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <ImageSource x:Key="RedCircle1"> images/sample/circleRed1.png </ImageSource>
</ResourceDictionary>

• 修改App.xaml合并资源：

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="FontResources.xaml"/>
            <ResourceDictionary Source="ImageResources.xaml"/>
        </ResourceDictionary.MergedDictionaries>
        
        <Style x:Key="HeaderTitle" TargetType="TextBlock">
            <Setter Property="Grid.Column" Value="0" />
            <Setter Property="HorizontalAlignment" Value="Left" />
            <Setter Property="VerticalAlignment" Value="Center" />
            <Setter Property="FontSize" Value="18" />
            <Setter Property="FontFamily" Value="{StaticResource NotoBold}" />
            <Setter Property="Foreground" Value="White" />
        </Style>
        <!-- 其他全局样式或资源 -->
    </ResourceDictionary>
</Application.Resources>

这种方法还能让你的资源管理更规整，后续维护也方便。

3. 升级Visual Studio到最新版本 #

这个bug在VS2019的16.10及以上版本已经被官方修复了，如果你不想改代码，直接把VS2019更到最新版，或者干脆升级到VS2022，就能彻底摆脱这个问题。

验证方法 #

用上面任意一种方法修改后，你可以：

• 查看XAML设计器的错误提示是否消失
• 运行程序确认字体和图片都能正常显示
• 调试后重启设计器，检查错误会不会复发

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