WPF中ViewModel的ObservableProperty未触发嵌套Model的PropertyChanged问题

为什么[ObservableProperty]不处理嵌套对象的内部属性变化？ #

[ObservableProperty]特性的核心作用是为ViewModel中的属性生成标准的get/set逻辑，并在属性的引用发生替换时（即给Settings属性赋值一个全新的Settings对象）触发PropertyChanged事件和对应的OnSettingsChanged回调。它的设计目标是处理顶层属性的引用变更，而非自动追踪嵌套对象内部的属性变化。

当你修改Settings.ServerPath时，触发的是Settings自身的PropertyChanged事件，ViewModel的[ObservableProperty]不会自动订阅子对象的事件——这不是功能缺陷，而是刻意的设计：工具包无法预知你是否需要追踪所有嵌套对象的内部状态变化，默认只处理顶层属性的引用变更。

无需手动编写完整属性的最优解决方案 #

你可以利用CommunityToolkit.Mvvm自动生成的partial回调方法，在Settings属性的引用发生变化时，自动订阅/取消订阅其PropertyChanged事件，同时转发内部属性的变更通知到ViewModel。这种方式既保留了[ObservableProperty]的便利性，又避免了手动编写完整的属性逻辑：

public partial class MyViewModel : ObservableObject
{
    [ObservableProperty]
    private Settings _settings;

    // 在Settings对象即将被替换时，取消订阅旧对象的事件
    partial void OnSettingsChanging(Settings? oldValue)
    {
        if (oldValue != null)
        {
            oldValue.PropertyChanged -= OnSettingsPropertyChanged;
        }
    }

    // 在Settings对象替换完成后，订阅新对象的事件
    partial void OnSettingsChanged(Settings? newValue)
    {
        if (newValue != null)
        {
            newValue.PropertyChanged += OnSettingsPropertyChanged;
        }
    }

    // 转发Settings内部属性的变更通知
    private void OnSettingsPropertyChanged(object? sender, PropertyChangedEventArgs e)
    {
        // 方式1：通知整个Settings属性变更，兼容所有嵌套属性绑定
        OnPropertyChanged(nameof(Settings));
        
        // 方式2：更精准的通知，仅触发具体嵌套属性的变更（性能更优）
        // OnPropertyChanged($"Settings.{e.PropertyName}");
    }
}

方案优势 #

• 完全基于CommunityToolkit.Mvvm的特性，无需手动编写完整的Settings属性get/set逻辑，减少样板代码。
• 自动处理旧对象的事件取消订阅，避免内存泄漏。
• 可选择精准通知具体嵌套属性，提升UI更新性能。

额外说明 #

如果你的UI绑定直接指向Settings.ServerPath这类嵌套属性，WPF本身可以直接响应Settings对象的PropertyChanged事件更新UI——只有在某些特殊场景下（例如UI元素依赖整个Settings对象的状态判断），才需要ViewModel转发通知。如果只是基础的双向绑定，你甚至不需要转发通知，直接依赖Settings自身的INotifyPropertyChanged实现即可。

内容的提问来源于stack exchange，提问作者Jim