WPF自定义控件BasedOn运行时为null，设计器正常问题排查

核心原因 #

这是无App.xaml的WPF类库项目中，资源加载顺序与隐式样式解析逻辑冲突导致的：

• 当窗口资源字典中定义的样式通过BasedOn="{StaticResource {x:Type controls:Heading}}"引用合并字典里的隐式样式（仅指定TargetType无x:Key的样式）时，WPF在初始化窗口资源的阶段，合并的Theme.xaml资源还未完全注册到当前资源查找上下文，导致StaticResource无法找到目标样式，最终BasedOn属性为null。
• 设计器显示正常是因为设计环境会提前加载所有资源；热重载后正常是因为此时资源已完成加载；指定Key或后台创建样式正常，是因为明确的Key引用或延迟初始化避开了资源加载顺序的问题。

解决方案 #

1. 给全局样式添加明确Key（最直接）

修改Theme.xaml中的样式，添加x:Key：

<Style x:Key="HeadingBaseStyle" TargetType="{x:Type controls3:Heading}">
    <!-- 原有Setter和ControlTemplate内容不变 -->
</Style>

然后窗口中的样式引用该Key：

<Style TargetType="controls:Heading" BasedOn="{StaticResource HeadingBaseStyle}">
    <Setter Property="Margin" Value="5 10 0 5" />
</Style>

2. 调整窗口资源加载顺序

在窗口构造函数中，先手动加载合并资源字典，再调用InitializeComponent()：

public YourWindow()
{
    // 先加载主题资源字典
    var themeDict = new ResourceDictionary();
    themeDict.Source = new Uri("/ProjectName.Addin;component/Windows/Theme.xaml", UriKind.RelativeOrAbsolute);
    Resources.MergedDictionaries.Add(themeDict);
    
    // 再初始化组件
    InitializeComponent();
}

同时可以移除XAML中Window.Resources里的MergedDictionaries定义，避免重复加载。

3. 注册应用级全局资源

在SolidWorks插件启动时，将Theme.xaml合并到应用级资源中，确保所有窗口都能直接访问：

// 插件初始化方法中执行
var themeDict = new ResourceDictionary
{
    Source = new Uri("/ProjectName.Addin;component/Windows/Theme.xaml", UriKind.RelativeOrAbsolute)
};
if (!Application.Current.Resources.MergedDictionaries.Contains(themeDict))
{
    Application.Current.Resources.MergedDictionaries.Add(themeDict);
}

这样窗口中的样式无需手动合并字典，直接通过TargetType继承即可。

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