WPF用户控件必须继承UserControl；依赖属性是暴露可绑定属性的唯一可靠方式；自定义控件需正确合并资源字典并配置Generic.xaml路径与命名空间。
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 的路径约束、设计器对程序集名称的敏感性，这三个地方出错频率最高，而且错误提示往往模糊（比如只说“无法解析类型”），实际跟拼写或构建顺序强相关。 
