事件监听器核心结构需用std::function+std::vector搭骨架,推荐std::weak_ptr管理生命周期,eventdispatcher负责注册/触发,connection对象实现安全注销,采用延迟删除避免迭代器失效,优先用结构体而非模板封装事件参数。

事件监听器的核心结构怎么设计
关键不是“监听”这个词,而是如何让多个回调函数能被统一注册、触发、管理。C++里没有原生事件系统,得靠 std::function + std::vector 搭出骨架,再用 std::shared_ptr 或裸指针解决生命周期问题——但裸指针容易悬空,std::shared_ptr 又可能循环引用,所以多数场景推荐用 std::weak_ptr 存储监听器。
一个最小可用结构包含三部分:EventDispatcher(负责注册/触发)、EventListener(可选基类,非必须)、以及事件类型标识(比如用 enum class EventType 或字符串)。不建议一开始就抽象成泛型模板,先跑通 int / string 类型的事件再扩展。
如何安全注册和移除监听器
注册时如果直接存 std::function,就无法在运行时主动注销——因为没句柄。常见做法是返回一个 Connection 对象,内部封装一个唯一 ID 或迭代器位置,调用其 disconnect() 时从容器中擦除对应项。
- 用
std::vector<:function>></:function>存回调,注册返回size_t索引 → 简单但不安全:删除中间项后索引失效 - 改用
std::list<:function>></:function>+std::list::iterator作 handle → 安全但遍历慢 - 更实用的是用
std::unordered_map<size_t std::function>></size_t>,注册返回 key,移除时按 key erase → 平衡了查找与删除成本
注意:不要在回调函数内部调用 disconnect(),否则会引发迭代器失效或容器重入问题;应改为标记待删(如 std::vector<bool></bool>),等本轮触发结束后再清理。
触发事件时怎么避免崩溃或漏调
最常踩的坑是:一边遍历监听器容器,一边在某个回调里调用 disconnect(),导致迭代器失效、内存访问违规。解决方案不是加锁(单线程没必要),而是“延迟删除”:
- 触发前拷贝一份监听器列表(
auto listeners = m_listeners;),然后遍历副本 - 所有回调都从副本调用,原始容器只读
- 允许回调内调用
disconnect(),它只修改原始容器,不影响当前遍历
另一个问题是异常传播:某个监听器抛异常会中断后续所有监听器执行。如果业务要求“尽力执行”,就在 try/catch 中包裹每个回调调用,而不是整个循环外包一层。
为什么别急着支持泛型事件参数
看到别人用 template<typename... args></typename...> 实现 emit<int std::string>(123, "hello")</int> 就跟着抄?先想清楚:你真需要不同事件传不同参数吗?多数项目里,事件本质是“通知发生了什么”,数据该由监听器自己去查状态,而非通过参数传递——否则耦合度飙升,测试也难 mock。
真要支持多参数,优先用结构体封装:
struct ButtonClickEvent { int x; int y; bool is_double; };
比模板推导更可控,调试时类型清晰,序列化/日志也方便。泛型 emit 函数容易让编译错误变得极其晦涩,尤其配合 lambda 捕获时。
真正复杂的地方不在语法,而在监听器生命周期和线程安全的取舍——单线程模型下用 weak_ptr 配合延迟删除已够用;一旦跨线程,就得明确谁负责销毁、是否允许异步投递、要不要队列缓冲。这些细节比“怎么写 emit”重要得多。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











