vue 3 废除 event bus，推荐 provide/inject（祖先-后代）、pinia（状态同步）或 mitt（松耦合广播）；不推荐模拟 vue 2 api，应借机重构通信契约。
Vue 3 中不再支持通过 Vue 实例实现的自定义事件总线（Event Bus），因为 $on、$off、$once 已被彻底移除。这不是功能倒退，而是为了推动更清晰、可维护、类型安全的通信方式。替代方案需根据通信范围、项目规模和协作规范来选，没有“万能解”，但有明确适用场景。
祖先-后代组件通信：用 provide / inject 传函数
当通信发生在有明确嵌套关系的组件之间（比如表单容器与内部多个子字段），provide/inject 是最轻量且语义最清晰的方式。它不依赖全局状态，也不引入额外依赖，还能在 TypeScript 中获得完整类型提示。
- 祖先组件通过
provide暴露一个具名函数（如'updateForm'），函数参数即为要传递的数据结构 - 后代组件用
inject获取该函数并调用，无需注册监听或手动清理 - 避免了事件名拼写错误，也杜绝了跨层级“意外触发”——函数只对注入它的组件可见
跨模块或全局状态变更：优先用 Pinia
如果所谓“事件”实质是状态更新（例如用户登录后刷新导航栏、切换主题、同步购物车），那它本质上不是“通知”，而是“状态同步”。Pinia 不仅能管理状态，还能封装事件逻辑，天然支持响应式、持久化、DevTools 调试和 TypeScript。
递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
- 把事件动作封装进 store 的 action，比如
userStore.loginSuccess()，内部自动触发相关副作用 - 组件只关心调用 action 或订阅 store 中的响应式属性，无需关心谁监听、谁响应
- 配合插件（如
pinia-plugin-persistedstate）还能让事件效果跨页面保留
仍需松耦合广播场景：mitt 是最稳妥的第三方选择
极少数情况确实需要类似“发布-订阅”的解耦机制（如第三方 SDK 触发埋点、微前端子应用间轻量协同），此时 mitt 是 Vue 官方文档明确推荐的替代库。它体积小（约 200B）、无依赖、API 简洁，且解决了 Vue 2 EventBus 的核心缺陷。
- 必须在
onMounted注册监听，在onUnmounted主动卸载，否则存在内存泄漏风险 - 事件名建议统一管理（如定义在
eventTypes.ts中），避免字符串散落各处 - payload 类型应显式声明，配合 TypeScript 接口确保调用方和监听方数据结构一致
不推荐继续模拟 Vue 2 API
有人试图用 tiny-emitter 封装一层，还原 $on/$emit 写法，甚至挂到 app.config.globalProperties 上。这种做法看似平滑迁移，实则延续了旧模式的所有隐患：隐式依赖、调试困难、类型缺失、难以测试。升级不是复制粘贴，而是借机重构通信契约。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
