WPF自定义控件不必须继承UserControl或Control，但需复用、模板化和样式化的应继承Control；UserControl仅适合简单界面封装，否则无法使用Generic.xaml模板和视觉状态。
WPF自定义控件必须继承 UserControl 或 Control 吗？
不是必须，但绝大多数场景下推荐继承 Control。继承 UserControl 适合组合已有控件的“界面封装”，而真正可复用、可样式化、支持模板（ControlTemplate）和视觉状态（VisualStateManager）的自定义控件，应继承 Control 或其子类（如 ButtonBase、ItemsControl）。否则无法通过 Generic.xaml 定义默认模板，也无法被主题系统识别。
常见错误现象：UserControl 子类在资源字典中设置 TargetType 后样式不生效，或调用 GetTemplateChild 返回 null —— 因为 UserControl 不走 WPF 的默认模板查找逻辑（即不查 Themes/Generic.xaml）。
- 若只需封装几个控件+简单逻辑，用
UserControl快速开发没问题 - 若需支持外部重写模板、绑定
TemplateBinding、响应IsEnabled/IsFocused等状态，必须继承Control - 继承
Control后，务必在Themes/Generic.xaml中声明Style并设置TargetType为你的类，且不设x:Key
为什么 OnApplyTemplate 里拿不到 GetTemplateChild("PART_XXX")？
根本原因：控件模板未正确加载，或命名契约（PART_XXX）未在 ControlTemplate 中声明，或调用时机不对。WPF 只有在控件应用了有效模板后才触发 OnApplyTemplate，而该方法是唯一安全获取 TemplatePart 的入口。
典型陷阱：
-
Generic.xaml没放在Themes文件夹下，或未在AssemblyInfo.cs中注册：[assembly: ThemeInfo(ResourceDictionaryLocation.None, ResourceDictionaryLocation.SourceAssembly)] -
ControlTemplate中写的是name="partClose"（小写），但代码里写GetTemplateChild("PART_Close")—— 名称必须完全一致，且按约定以PART_开头 - 在构造函数或
Loaded事件中提前调用GetTemplateChild，此时模板尚未应用 - 模板中漏掉某个
PART_元素（比如忘了加Border且命名为PART_Root），GetTemplateChild就返回null，不抛异常
DependencyProperty 声明时为什么必须用 public static readonly 字段？
因为 WPF 属性系统在运行时通过反射查找静态字段来注册依赖属性。如果写成 private、internal，或不是 static readonly，XAML 解析器和属性系统将无法定位它，导致绑定失败、动画无效、甚至设计时崩溃。
实操要点：
- 字段名必须与属性名一致（如
TextProperty对应Text属性），这是 XAML 解析硬编码的约定 - 回调函数（
PropertyChangedCallback）里不能直接操作 UI 控件（如更新TextBlock.Text），因为可能在模板未应用前就被调用；应标记脏状态，延迟到OnApplyTemplate后再同步 - 避免在
CoerceValueCallback中引发新属性变更，容易造成死循环 - 注册时传入的
PropertyMetadata中的默认值，必须是 XAML 可序列化的常量（如0、"abc"、Brushes.Red），不能是new Brush()这类运行时对象
如何让自定义控件支持设计时数据和 Blend 编辑？
关键不在控件本身，而在 Generic.xaml 模板和设计时上下文配置。WPF 设计器（VS / Blend）只认 Themes/Generic.xaml 中的默认样式，并且会跳过所有运行时逻辑（如 OnApplyTemplate）。
- 确保
Generic.xaml中的ControlTemplate包含完整结构（哪怕只是占位TextBlock），否则设计器渲染为空白 - 在控件类上加特性：
[DefaultEvent("Click")]、[ContentProperty("Content")]，提升设计器体验 - 为常用依赖属性添加
[Category("Appearance")]、[Description("显示文本内容")]等特性，让属性面板分组清晰 - 若需设计时模拟数据，可在
ControlTemplate中用d:DataContext绑定示例数据（需引入xmlns:d="http://schemas.microsoft.com/expression/blend/2008"）
最易忽略的一点：发布 NuGet 包时，必须把 Themes\Generic.xaml 设为 Resource 构建操作，并确保 AssemblyInfo.cs 中的 ThemeInfo 指向正确位置 —— 否则下游项目引用后，控件变成“无样式方块”，连边框都看不到。
