WPF中DependencyProperty必须声明为public static readonly，配对实现get/set包装器，回调函数须为static且通过参数转换访问实例，绑定默认为OneWay需显式设TwoWay或使用BindsTwoWayByDefault。
WPF 中 DependencyProperty 必须用 public static readonly 声明
DependencyProperty 不是普通字段，它本身是 DependencyProperty 类型的静态只读字段，由 DependencyProperty.Register 返回。如果声明成实例字段、非 readonly 或非 static，XAML 加载时会直接抛出 XamlParseException，错误信息类似 “The property ‘XXX’ was not found in type ‘YYY’”。
正确写法必须严格遵循命名约定：属性名 + Property 后缀，且注册名（第一个参数）必须与依赖属性包装器名称一致（不含 Property）：
public static readonly DependencyProperty IsExpandedProperty =
DependencyProperty.Register(
nameof(IsExpanded), // ← 必须是 "IsExpanded"，不是 "IsExpandedProperty"
typeof(bool),
typeof(MyControl),
new PropertyMetadata(false));
依赖属性必须配对实现 .NET 属性包装器
仅声明 DependencyProperty 字段无法在 C# 代码中以 obj.IsExpanded = true 方式使用，必须提供标准的 get/set 访问器，内部调用 GetValue/SetValue。否则编译不报错，但运行时赋值无效，绑定也不会响应。
常见错误包括：忘记 GetValue、误用 this. 访问私有字段、或在 set 中调用 base.SetValue（WPF 控件应直接调用 SetValue）：
public bool IsExpanded
{
get => (bool)GetValue(IsExpandedProperty);
set => SetValue(IsExpandedProperty, value);
}
- get 中必须显式转换类型，
GetValue返回object - set 中不能写
base.SetValue(...)（除非你继承的是FrameworkElement且重写了该方法，一般不用） - 不要在 set 中加逻辑判断再调用
SetValue——这会绕过 WPF 的变更通知和绑定系统
回调函数（PropertyChangedCallback）里不能直接访问 this.DataContext
当依赖属性值变化触发 PropertyChangedCallback 时，回调执行在静态上下文中，此时 this 不可用。传入的是 DependencyObject（通常是你的控件实例），需先强制转换才能访问实例成员：
static void OnIsExpandedChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
if (d is MyControl control)
{
// ✅ 正确：先转换再用
control.UpdateVisualState();
}
}
容易踩的坑：
