WPF双向绑定生效需确保INotifyPropertyChanged事件被正确触发且属性名严格匹配绑定路径；OnPropertyChanged("Name")无效常见于拼写错误、大小写不符或传入字段名，应使用nameof避免硬编码，同时保证属性setter内调用、依赖属性变更时手动通知、集合使用ObservableCollection且嵌套对象自身实现通知机制。
WPF 的双向绑定要生效，INotifyPropertyChanged 不是“加了就行”，必须确保属性变更时真触发了 PropertyChanged 事件，且事件参数里的属性名完全匹配绑定路径。
为什么 OnPropertyChanged("Name") 不起作用？
常见错误是手动传错字符串：拼写不一致、大小写不对、或用了字段名而非属性名。WPF 绑定引擎严格按字符串匹配，Binding Path=UserName 对应的就必须是 OnPropertyChanged("UserName")，写成 "username" 或 "_userName" 都无效。
更稳妥的做法是用 nameof：
private string _userName;
public string UserName
{
get => _userName;
set
{
if (_userName != value)
{
_userName = value;
OnPropertyChanged(nameof(UserName)); // ✅ 安全，重构时自动同步
}
}
}
- 避免硬编码字符串，防止重命名属性后忘记改事件名
- 不要在 setter 外部（比如后台线程）直接改字段值，否则事件不会触发
- 如果属性依赖其他属性（如
FullName由FirstName和LastName拼接），修改任一依赖项后，也要手动触发FullName的通知
INotifyPropertyChanged 实现方式选哪个？
手写 INotifyPropertyChanged 接口最直接，但样板代码多；.NET 6+ 推荐用 ObservableObject（来自 CommunityToolkit.Mvvm），它已内置线程安全的 SetProperty 方法：
public partial class Person : ObservableObject
{
[ObservableProperty]
private string _name; // ✅ 自动生成 Name 属性 + 通知逻辑
}
如果你不用源生成器，就别自己封装 SetProperty 方法——容易漏掉 null 比较或引发重复通知。原生接口实现只要保证三点：
- 继承
INotifyPropertyChanged - 声明
public event PropertyChangedEventHandler PropertyChanged; - 提供一个非空、线程安全的
OnPropertyChanged辅助方法（检查PropertyChanged != null再调用）
绑定到 List<T> 时 UI 为何不更新？
List<T> 本身不实现 INotifyCollectionChanged，所以往里 Add 或 Clear 元素，UI 不会响应。必须换用 ObservableCollection<T>。
但注意：ObservableCollection<T> 只通知“集合结构变化”（增删改项），不通知“集合中某项内部属性变化”。例如：
var list = new ObservableCollection<Person>();
list.Add(new Person { Name = "A" });
// ✅ list.Add() → UI 列表增加一行
// ❌ list[0].Name = "B" → UI 不刷新，除非 Person 也实现了 INotifyPropertyChanged
- 嵌套对象（如
Person）必须自己实现INotifyPropertyChanged - 若用
ICollectionView做排序/筛选，记得用CollectionViewSource.GetDefaultView(collection)获取视图，别直接绑原集合 - 大数据量时慎用
ObservableCollection，频繁 Add/Remove 触发大量通知，可考虑批量操作 +Reset，或换用虚拟化容器
调试绑定失败的三个关键位置
WPF 绑定失败默认静默，需打开绑定日志：
- 启动时加
BindingNotification：在 App.xaml.cs 的OnStartup中设置System.Diagnostics.PresentationTraceSources.DataBindingSource.Switch.Level = SourceLevels.Warning; - 检查输出窗口里是否出现类似
System.Windows.Data Error: 40 : BindingExpression path error: 'UserName' property not found on 'object' - 确认 DataContext 类型和实际实例一致——常因
DataContext = this写错位置（比如写在构造函数里，但 InitializeComponent() 后才真正初始化控件）导致绑定目标为空
最容易被忽略的是：属性 getter 抛异常（哪怕只是 NullReferenceException）会导致整个绑定链中断，且不报错，只显示默认值或空白。务必确保所有绑定路径上的属性 getter 是纯读取、无副作用、不抛异常。
