WPF 中自定义控件主要有两种方式：用户控件（UserControl）和自定义控件（CustomControl），适用场景不同。用户控件适合封装一组已有控件的组合逻辑，开发快、易上手；自定义控件更适合需要深度样式定制、模板化、支持主题切换或作为可复用组件发布的场景。
创建用户控件（UserControl）
这是最常用、最轻量的自定义方式，本质是一个带 XAML 和后台代码的“页面片段”。
在项目中右键 → “添加” → “新建项”，选择“用户控件（WPF）”，输入名称（如 MyButtonPanel.xaml） XAML 中直接写布局，比如放一个Border包着
Button和
TextBlock后台代码（.xaml.cs）中可定义依赖属性、事件处理、简单逻辑，例如暴露一个
LabelText属性绑定到内部
TextBlock.Text使用时在其他 XAML 中先声明命名空间：
创建自定义控件（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 更规范——按实际需求选，别一上来就硬啃后者。
