WPF DataGrid HeaderTemplate失效：列标题显示空白

数据老陈

2026-6-19

WPF DataGrid列标题空白的排查与解决

针对你遇到的列标题空白问题，从你的代码来看，主要可以从以下几个方面排查：

动态资源FilesTabIcon未正确定义
你在HeaderTemplate的Image中使用了{DynamicResource FilesTabIcon}，首先要确认这个资源是否在项目的资源字典（比如App.xaml或当前窗口的Resources）中正确注册。示例正确的资源定义应该是：
```

<BitmapImage x:Key="FilesTabIcon" UriSource="/你的程序集名称;component/Images/文件图标.png" />
```
注意替换程序集名称和图片路径，如果资源不存在或路径错误，Image会加载失败，导致整个Header内容显示异常。
列宽设置可能导致内容被压缩
你的列设置了Width="auto"，但Header的StackPanel可能因为初始没有可计算的宽度被压缩成空白。可以先将列宽改为固定值（比如Width="120"）或者Width="*"，验证Header内容是否能正常显示，排除布局压缩的问题。
HeaderTemplate未被正确触发
部分情况下，DataGridTemplateColumn需要显式设置Header属性才能让HeaderTemplate生效，即使Header内容由模板提供。可以尝试添加Header="Name"到DataGridTemplateColumn标签中：
```
<DataGridTemplateColumn Width="auto" SortMemberPath="Name" Header="Name">
```

默认样式覆盖自定义模板
DataGridColumnHeader的默认样式可能会影响自定义HeaderTemplate的渲染。可以显式设置HeaderStyle来确保内容正常显示：

<DataGridTemplateColumn.HeaderStyle>
    <Style TargetType="DataGridColumnHeader">
        <Setter Property="HorizontalContentAlignment" Value="Left"/>
        <Setter Property="Padding" Value="4"/>
    </Style>
</DataGridTemplateColumn.HeaderStyle>

Image绑定方式问题
暂时替换动态资源为直接的图片路径，验证Image是否能正常加载：
```
<Image Source="/你的程序集名称;component/Images/文件图标.png" Width="19" Height="19"/>
```
如果这样能显示，说明动态资源的定义或加载存在问题。