WPF用户控件必须继承 UserControl
，不能用 Window
或 Control
新建 WPF 用户控件时，VS 模板默认生成继承
UserControl的类和对应 XAML。若手动创建或误选模板（比如选了“自定义控件”），会继承
Control—— 它没有
Content、不自动支持
Grid布局根元素，也无法直接拖入
MainWindow设计器（设计器报错：“无法创建抽象类的实例”）。确认你的类定义是：
public partial class MyCustomControl : UserControl，不是
Control或
FrameworkElement。
依赖属性（DependencyProperty
）是暴露可绑定属性的唯一可靠方式
想让外部 XAML 能设置属性（如
MyCustomControl Title="Hello"）、支持数据绑定或样式触发器，必须用依赖属性。普通 CLR 属性（
public string Title { get; set; }）在 WPF 中只读、不响应绑定更新、不参与属性系统调度。常见错误：写完依赖属性但忘了注册元数据或回调函数，导致
PropertyChangedCallback不触发；或者把
OwnerType写成
typeof(Control)而非
typeof(MyCustomControl)。
正确写法要点： 使用
DependencyProperty.Register，
OwnerType必须是你自己的控件类型 CLR 包装器中，
GetValue/
SetValue的参数名要和注册时一致（大小写敏感） 需要响应值变化？传入
new PropertyMetadata(defaultValue, OnTitleChanged)避免在回调里直接操作 UI 元素（如
TextBlock.Text = newValue），应走 MVVM 或通过
SetCurrentValue触发内部更新逻辑
自定义控件资源字典未合并会导致样式/模板找不到
如果你把
ControlTemplate或
Style单独放在
Themes/Generic.xaml里，但没在控件构造函数中调用
DefaultStyleKeyProperty.OverrideMetadata，WPF 就不会加载该模板——结果是控件显示为空白或仅显示默认灰色矩形。
必须在控件类的静态构造函数中添加：
static MyCustomControl(){<br> DefaultStyleKeyProperty.OverrideMetadata(typeof(MyCustomControl), new FrameworkPropertyMetadata(typeof(MyCustomControl)));<br>}，且确保
Generic.xaml构建操作为
Page，并位于
Themes文件夹下。如果只是简单复用，直接在用户控件的 XAML 中定义
Resources更稳妥，无需走主题机制。
设计器不刷新或报错“未知的属性”通常因命名空间未正确定义
在主窗口 XAML 中引用自定义控件时，XAML 命名空间声明必须与控件所在程序集和命名空间完全匹配。例如控件类是
namespace MyApp.Controls，程序集名为
MyApp，则必须写：
xmlns:local="clr-namespace:MyApp.Controls;assembly=MyApp"。漏掉
assembly=...在运行时可能正常，但设计器常报红；若程序集名含空格或点号（如
My.App.UI），需用单引号包裹：
assembly='My.App.UI'。另一个常见坑：控件项目尚未生成（Build 状态为“跳过”），导致设计器找不到类型——务必先 Build 一次再打开 XAML。 依赖属性注册细节、
Generic.xaml的路径约束、设计器对程序集名称的敏感性，这三个地方出错频率最高，而且错误提示往往模糊（比如只说“无法解析类型”），实际跟拼写或构建顺序强相关。
