事件总线的核心是用std::unordered_map以事件id为键、std::vector为值管理回调,配合变参模板实现类型安全的参数转发,注册时惰性建表,触发时拷贝回调列表执行以避免遍历中删除崩溃。

事件总线的核心是函数对象容器和类型擦除
直接用 std::function<void></void> 存储回调最简单,但实际中事件往往带参数(比如 std::function<void const std::string></void>),不同事件类型不能混存。所以得用类型擦除——常见做法是把「事件名」作为键,值为 std::vector<:function>> </:function>,但这样需要为每种签名单独定义容器。更通用的方案是:用 std::string 或枚举作事件 ID,配合 std::any 或变参模板做参数转发。
推荐用变参模板 + std::function 组合,避免运行时类型转换开销。关键不是“支持任意参数”,而是“同一事件名下所有监听器签名必须一致”——这是多数轻量级总线的实际约束,强行泛化反而难调试。
用 std::unordered_map 管理事件名到回调列表的映射
别用 std::map,除非你需要按字典序遍历;std::unordered_map 查找平均 O(1),更符合事件触发高频、注册低频的场景。键用 std::string 最灵活(比如 "player.jump"),但要注意短字符串优化是否生效;若追求极致性能且事件名固定,可用 enum class 配合 std::array。
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 注册时检查键是否存在:不存在就新建空
std::vector,存在则 push_back - 触发时先查 map,找不到键直接 return(不报错),避免异常打断逻辑流
- 删除监听器建议用 token 机制(返回一个
int或void*),而不是暴露 vector 迭代器——后者在多线程或中间 erase 时极易失效
如何安全地移除正在执行中的回调
最常见 crash 场景:回调里调用 unsubscribe(),导致正在遍历的 std::vector 被修改。解决方案不是加锁(性能差),而是延迟删除:
- 触发前拷贝一份回调列表(
auto handlers = m_handlers[event_id];) - 遍历拷贝副本执行,原容器只读
- 另设一个
std::vector<:function>> m_pending_unsubscribes</:function>,由用户调用unsubscribe()时写入待删项,触发结束后批量清理 - 或者更轻量:用
std::shared_ptr包裹每个 handler,注册时返回std::weak_ptr,触发前 lock() 成功才调用——天然规避悬空指针
避免模板爆炸和编译时间失控
如果为每种参数组合都实例化一个 EventBus<args...></args...>,头文件包含稍多就会让编译变慢。折中办法是限定常用签名:
- 只提供
void()、void(void*)、void(const std::any&)三种基础模板特化 - 或者统一用
std::any接收参数,内部用std::any_cast转换,牺牲一点类型安全换取编译速度 - 别在类模板里放大量 SFINAE 检查——调试时错误信息会极其晦涩,比如
static_assert(std::is_invocable_v<f args...>, "...")</f>就比推导失败友好得多
真正难处理的从来不是怎么注册回调,而是跨模块生命周期管理:谁负责销毁 listener?EventBus 实例是否 static?这些比语法细节更容易引发野指针或重复触发。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!










