WPF自定义控件分UserControl和CustomControl：UserControl适合快速封装控件组合，轻量易用；CustomControl继承Control类，依赖ControlTemplate，支持主题切换与深度定制，适用于可复用控件库。
WPF 中自定义控件主要有两种方式：用户控件（UserControl）和自定义控件（CustomControl），适用场景不同。用户控件适合封装一组已有控件的组合逻辑，开发快、易上手；自定义控件更适合需要深度样式定制、模板化、支持主题切换或作为可复用组件发布的场景。
创建用户控件（UserControl）
这是最常用、最轻量的自定义方式，本质是一个带 XAML 和后台代码的“页面片段”。
- 在项目中右键 → “添加” → “新建项”，选择“用户控件（WPF）”，输入名称（如 MyButtonPanel.xaml）
- XAML 中直接写布局，比如放一个
Border包着Button和TextBlock - 后台代码（.xaml.cs）中可定义依赖属性、事件处理、简单逻辑，例如暴露一个
LabelText属性绑定到内部TextBlock.Text - 使用时在其他 XAML 中先声明命名空间：
<local:MyButtonPanel LabelText="确定" Click="OnPanelClick"/>
创建自定义控件（CustomControl）
它继承自 Control 类，不带默认外观，完全靠 ControlTemplate 驱动，支持模板重写和主题资源字典，适合做真正可复用的“控件库”组件。
- 右键添加 → “新建项” → “自定义控件（WPF）”，如 RoundButton.cs
- 系统会自动生成类（继承
Control）和 Themes/Generic.xaml 文件 - 在
Generic.xaml中定义默认模板，用TargetType="{x:Type local:RoundButton}"关联 - 必须在静态构造函数中调用
DefaultStyleKeyProperty.OverrideMetadata，否则模板不生效 - 通过依赖属性暴露行为（如
CornerRadius、IsHighlighted），并在模板中用TemplateBinding或Binding RelativeSource={RelativeSource TemplatedParent}绑定
关键区别与选型建议
别把 UserControl 当 CustomControl 用——前者不能被模板彻底重写（改外观要改 XAML 结构），后者可以。
- 做登录框、设置面板这类“功能组合” → 用 UserControl
- 做按钮、滑块、带图标标签等需统一风格、支持 Dark/Light 主题、可能被别人引用的组件 → 用 CustomControl
- 想让 UserControl 支持模板？可以，但得手动加
ContentPresenter和TemplateBinding，不如直接上 CustomControl 干净
小技巧：快速提升复用性
不管哪种方式，都建议尽早考虑扩展性：
- 所有可变内容尽量走依赖属性，避免硬编码文本或颜色
- UserControl 中用
x:Name的元素，若需外部访问，记得设public属性包装（不推荐直接暴露内部控件） - CustomControl 的默认模板里，把交互逻辑（如鼠标悬停变色）写进
VisualStateManager，而不是代码里写事件 - 资源字典分离：把样式、模板抽到单独的
Themes/Controls.xaml，便于维护和换肤
基本上就这些。UserControl 上手快，CustomControl 更规范——按实际需求选，别一上来就硬啃后者。
