WPF自定义控件应据需求选UserControl（封装组合控件）或Control（完全模板化）；后者需配Generic.xaml、DefaultStyleKey及正确ThemeInfo，否则模板失效、主题不响应、控件空白。
WPF自定义控件该继承 UserControl 还是 Control
取决于你是否需要封装“已有控件组合”还是从头定义外观与行为。用错基类会导致模板失效、样式不生效、无法响应主题变更。
-
UserControl适合把几个现成控件（如TextBox+Button）打包成逻辑单元，自带默认Content和可视化树，但不能被ControlTemplate替换整个视觉结构 -
Control是纯行为容器，必须配合DefaultStyleKey和Themes/Generic.xaml才能显示，但支持完整模板化、主题切换、状态触发器（VisualStateManager） - 常见错误：继承
Control却没配Generic.xaml，运行时控件完全空白，控制台无报错，只在输出窗口看到"Cannot find resource named '...'"
如何让自定义控件响应主题变化（比如浅色/深色模式）
靠硬编码颜色或资源键会失效。WPF 主题切换依赖 ResourceDictionary 的合并顺序和 BasedOn 继承链，不是改系统设置就能自动适配。
- 所有颜色、画刷必须从
{DynamicResource {x:Static SystemColors.WindowBrushKey}}或{DynamicResource {x:Static vs:VsColors.WindowBackgroundKey}}这类动态资源取，不能用{StaticResource} - 在
Themes/Generic.xaml中定义控件默认样式时，Style的TargetType必须设为你的控件类型，且BasedOn指向{StaticResource {x:Type Control}}或更上层基础样式 - VS 插件或第三方主题（如 MahApps）可能覆盖
SystemColors，建议用vs:VsColors（需引用Microsoft.VisualStudio.Shell.15.0）或自己定义可绑定的Brush属性
DependencyProperty 声明时为什么不能直接赋初值
因为 WPF 的属性系统在控件实例化前就扫描静态字段，直接赋值会覆盖后续通过 XAML 或绑定设置的值，尤其影响模板内子控件对父控件属性的继承。
- 正确写法：
public static readonly DependencyProperty ValueProperty = DependencyProperty.Register("Value", typeof(int), typeof(MyControl), new PropertyMetadata(0));—— 初值写在PropertyMetadata构造函数里 - 错误写法：
public int Value { get => (int)GetValue(ValueProperty); set => SetValue(ValueProperty, value); } private int _value = 42;—— 这个_value字段完全没用，且干扰调试 - 如果需要初始化逻辑（比如首次加载时触发计算），放在
OnApplyTemplate或Loaded事件里，而不是属性 getter 中
调试模板找不到、触发器不生效的三个关键检查点
这类问题往往卡住半天，其实只跟三处配置强相关，和代码逻辑无关。
- 确认项目属性中
AssemblyInfo.cs包含[assembly: ThemeInfo(ResourceDictionaryLocation.None, ResourceDictionaryLocation.SourceAssembly)]；若用了外部主题 DLL，第二参数要改成ResourceDictionaryLocation.ExternalAssembly - 确认
Themes/Generic.xaml文件的生成操作（Build Action）是Page，而非Resource或Content；否则编译后不会嵌入到程序集资源中 - 确认控件构造函数里写了
DefaultStyleKeyProperty.OverrideMetadata(typeof(MyControl), new FrameworkPropertyMetadata(typeof(MyControl)));，漏掉这句，WPF 根本不会去查Generic.xaml
实际开发中最容易忽略的是 Generic.xaml 的 Build Action 设置 —— 它不报错、不警告，只是默默让整个模板系统失效。改完记得清空 obj 目录再重编。
