CommunityToolkit.Mvvm 需手动确保属性变更通知、正确使用 IAsyncRelayCommand 防假死、避免 ViewModel 内存泄漏，并验证 Release 模式下源生成器通知有效性。
CommunityToolkit.Mvvm 不是“开箱即用就安全”的 MVVM 库——它省去了 INotifyPropertyChanged 手写样板，但默认行为、线程模型和生命周期管理稍有不慎就会导致绑定失效、内存泄漏或 UI 冻结。
为什么 ObservableObject 的属性变更不触发 UI 更新？
最常见原因是：属性 setter 没调用基类的 OnPropertyChanged，或用了字段直接赋值绕过 setter。
- 必须用
set访问器，并在其中显式调用OnPropertyChanged()（或使用[NotifyPropertyChangedFor]等源生成器特性） - 避免字段直写：
_name = value;不会通知；必须走Name = value; - 若启用了源生成器（推荐），需确保项目启用
Nullable和ImplicitUsings，且CommunityToolkit.Mvvm.SourceGenerators包已安装 - 调试时可临时重写
OnPropertyChanged(string?)加断点，确认是否被调用
如何正确使用 IAsyncRelayCommand 防止重复点击和 UI 假死？
IAsyncRelayCommand 默认禁用命令期间的执行，但它的“禁用逻辑”依赖于 UI 层绑定的 IsEnabled，而这个状态不会自动传播到所有控件（比如自定义模板里的按钮）。
- 务必绑定到控件的
Command属性，而非手动调用ExecuteAsync()—— 否则禁用逻辑失效 - 不要在命令体里用
await Task.Run(...)包裹 CPU 密集操作；应改用Task.Run+DispatcherQueue回 UI 线程更新，否则可能跨线程访问 UI 元素 - 若需取消，传入
CancellationToken并在构造IAsyncRelayCommand时启用allowsMultipleExecutions: false（默认就是 false） - 示例：
new IAsyncRelayCommand(DoWorkAsync, canExecute: () => IsConnected, allowsMultipleExecutions: false)
ViewModel 生命周期与内存泄漏的隐性关联
CommunityToolkit.Mvvm 本身不管理 ViewModel 实例生命周期。如果你在 View 中 new 出 ViewModel，又没清理对 View 或其事件的引用，就容易泄漏。
- 避免在 ViewModel 里订阅 View 的事件（如
Loaded、SizeChanged）—— 改用WeakEventManager或在Dispose()中显式取消 - 若使用依赖注入（如
Microsoft.Extensions.DependencyInjection），注意注册生命周期：AddTransient适合每次导航新建；AddScoped更常用，但需配合框架的导航上下文（如 WinUI 的Frame） -
ObservableRecipient提供了WeakReferenceMessenger的快捷接入，但必须确保发送方和接收方都使用同一Messenger实例（默认静态实例即可），否则消息“发出去就消失”
最容易被忽略的是：源生成器生成的属性变更通知，在 Release 模式下可能因编译器优化而跳过某些 setter 调用——务必在 Release 下验证绑定是否仍生效，必要时加 [MethodImpl(MethodImplOptions.AggressiveInlining)] 或关闭相关优化。
