WeakEventManager通过弱引用管理事件订阅，防止页面因事件强引用滞留导致内存泄漏；其核心是自动清理无需手动解绑，适用于跨生命周期事件通信，而页面内控件事件则无需使用。
MAUI 中用 WeakEventManager（注意不是 WeakReferenceManager，后者并不存在于 .NET MAUI 官方 API）替代传统事件订阅，是防止页面/控件因事件强引用滞留导致内存泄漏的核心手段。关键不在“怎么加”，而在“不手动解绑也能自动清理”。
为什么 WeakEventManager 能防泄漏
普通事件订阅（如 button.Clicked += OnClick;）会让发布者（button）持有一个指向订阅者（比如某页的实例方法）的强引用。页面导航出栈后若未显式 -=，该页面仍被 button 持有，无法被 GC 回收。
WeakEventManager 内部用弱引用来持有事件处理者，即使页面已出栈、无其他引用，GC 仍可安全回收它——button 不会阻止页面销毁。
正确使用 WeakEventManager 的三步法
- 定义事件时，用
WeakEventManager<teventargs></teventargs>管理，不要暴露 public event - 订阅写法统一为
eventManager.AddEventHandler(handler)，而非+= - 取消订阅用
eventManager.RemoveEventHandler(handler)；若忘记调用，也不影响内存释放（这是和传统方式的本质区别）
典型场景：自定义服务中的事件通信
比如一个图片加载服务，多个页面可能监听 ImageLoaded 事件：
public class ImageLoaderService
{
private readonly WeakEventManager<ImageLoadedEventArgs> _eventManager = new();
public event EventHandler<ImageLoadedEventArgs> ImageLoaded
{
add => _eventManager.AddEventHandler(value);
remove => _eventManager.RemoveEventHandler(value);
}
public void LoadImage(string url)
{
// ... 加载完成后触发
_eventManager.HandleEvent(this, new ImageLoadedEventArgs(url), nameof(ImageLoaded));
}
}
页面中订阅无需担心生命周期匹配问题：
// 在 OnAppearing 中订阅即可，不用管 OnDisappearing 解绑 imageLoader.ImageLoaded += OnImageLoaded; // 即使没写 -=，页面 Pop 后也会被回收
哪些地方必须用，哪些可以不用
- 跨页面、跨服务、生命周期不一致的事件通信（推荐必用）
- 页面内控件事件（如 Button.Clicked）——不需要，因为控件与页面同生共死，无泄漏风险
- 静态类或单例中发布的事件（高危！必须用 WeakEventManager 或手动管理）
- Timer、BackgroundService 等长期运行对象触发的回调（建议用，避免持住页面实例）
基本上就这些。WeakEventManager 不是银弹，但它把“解绑遗漏”这个高频泄漏原因直接从开发清单里划掉了。
