WPF引用icon.xaml中PathGeometry图标不显示问题咨询

这类问题基本由三类配置错误导致：资源字典未加入可查找范围、资源键不匹配、自定义控件模板未适配Geometry类型图标。

1. 第一步：正确合并icon.xaml资源字典 #

独立存放的icon.xaml不会自动被WPF资源系统识别，必须显式合并到资源查找层级中，最稳妥的方式是在App.xaml做全局注册：

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <!-- 替换为你项目中icon.xaml的实际路径，格式为 程序集名;component/文件相对路径 -->
            <ResourceDictionary Source="/WpfApp1;component/Assets/icon.xaml"/>
            <!-- 其他原有资源字典（比如按钮样式、画刷资源）保留在下方 -->
        </ResourceDictionary.MergedDictionaries>

        <!-- 原有全局资源比如PrimaryBlueColor可放在MergedDictionaries标签外部 -->
        <SolidColorBrush x:Key="PrimaryBlueColor" Color="#1677ff"/>
    </ResourceDictionary>
</Application.Resources>

如果不想全局注册，也可以把icon.xaml合并到当前承载菜单的Window/Page的<Window.Resources>/<Page.Resources>节点下。

2. 第二步：校验icon.xaml内的资源定义 #

打开icon.xaml，确认每个图标资源符合以下要求：

• 根节点是ResourceDictionary，正确声明WPF和XAML命名空间
• 每个PathGeometry必须设置x:Key属性，键名和你XAML中引用的名称完全一致（WPF资源键区分大小写）
• 不要用x:Name代替x:Key，资源查找逻辑不识别x:Name

正确的icon.xaml示例代码：

<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <!-- 键名必须和引用处的DynamicResource参数完全对应 -->
    <PathGeometry x:Key="home" Figures="M10 20v-6h4v6h5v-8h3L12 3 2 12h3v8z"/>
    <PathGeometry x:Key="dashboard" Figures="M3 13h8V3H3v10zm0 8h8v-6H3v6zm10 0h8V11h-8v10zm0-18v6h8V3h-8z"/>
    <PathGeometry x:Key="products" Figures="M7 18c-1.1 0-1.99.9-1.99 2S5.9 22 7 22s2-.9 2-2-.9-2-2-2zM1 2v2h2l3.6 7.59-1.35 2.45c-.16.28-.25.61-.25.96 0 1.1.9 2 2 2h12v-2H7.42c-.14 0-.25-.11-.25-.25l.03-.12.9-1.63h7.45c.75 0 1.41-.41 1.75-1.03l3.58-6.49c.08-.14.12-.31.12-.48 0-.55-.45-1-1-1H5.21l-.94-2H1zm16 16c-1.1 0-1.99.9-1.99 2s.89 2 1.99 2 2-.9 2-2-.9-2-2-2z"/>
    <!-- 其余car、email、billing、lock、settings等图标按相同格式定义 -->
</ResourceDictionary>

3. 第三步：校验自定义MenuItem控件的图标渲染逻辑 #

这是最容易忽略的点：你使用的ctls:MenuItem是自定义控件，必须确认它的控件模板中，Icon属性是通过Path控件渲染的，而不是Image控件：

• 如果模板中用Image绑定Icon属性：Image仅支持ImageSource类型资源，传入PathGeometry会直接显示空白
• 正确的图标部分模板写法如下：

<!-- 自定义MenuItem控件模板内的图标区域 -->
<Path Width="{Binding IconWidth, RelativeSource={RelativeSource AncestorType=ctls:MenuItem}}"
      Height="{Binding IconWidth, RelativeSource={RelativeSource AncestorType=ctls:MenuItem}}"
      Data="{Binding Icon, RelativeSource={RelativeSource AncestorType=ctls:MenuItem}}"
      Fill="{Binding IndicatorBrush, RelativeSource={RelativeSource AncestorType=ctls:MenuItem}}"
      Stretch="Uniform"
      VerticalAlignment="Center"/>

引用方式说明 #

你当前代码中用DynamicResource引用图标的写法本身没有问题：

• 如果资源是在窗口/应用初始化前就合并完成的，替换为StaticResource加载性能会更好
• 如果是运行时动态切换主题/图标资源，保留DynamicResource即可

配置完成后图标即可正常渲染，效果如下：

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