Vue组件通信命名冲突需建立隔离机制：自定义事件用kebab-case加业务前缀；Vuex模块名全局唯一；Provide/Inject的key带作用域前缀或Symbol；事件总线改用mitt或加命名空间。
Vue.js 中组件通信的命名冲突，主要出现在自定义事件名、Vuex 模块名、Provide/Inject 的 key 以及全局事件总线这几个环节。冲突不报错，但会导致行为异常、状态覆盖或监听失效，排查困难。关键不是“怎么起名”，而是建立统一的隔离机制。
自定义事件名必须用 kebab-case 并避开原生事件
子组件通过 emit 触发事件时，若命名为 click、input 或 submit，会与 DOM 原生事件同名，Vue 可能复用底层机制，导致事件冒泡异常、表单默认行为被抑制，甚至父组件监听不到。
- ✅ 正确写法：使用短横线分隔、语义明确、加业务前缀，如
form-submitted、user-profile-updated、table-row-selected - ❌ 避免写法：
userCreated（驼峰，在模板中@userCreated实际无法匹配）、on-change（含原生关键词）、submit（直接冲突） - 可在
setup中封装校验函数，运行时提醒：safeEmit('user-logged-in')，自动拦截已知危险词
Vuex 模块注册名必须全局唯一
模块名由 store/modules 中 modules 对象的键决定，不是文件名，也不是导出对象里的字段。重复 key 会导致后注册模块完全覆盖前一个，即使都设置了 namespaced: true 也无效。
Wjs Uploading Video
下载
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- 检查
src/store/index.js的modules配置，禁止出现两个user或auth这样的重复键 - 团队协作时，建议导入变量名与模块 key 保持一致，例如
import userModule from './modules/user'→ 注册为user: userModule - 在模块导出顶部添加版本注释，如
// [user v2.3] exported at 2026-06-15，便于排查加载了旧版模块
Provide/Inject 的 key 要带作用域前缀
provide 提供的数据在祖先组件中声明，后代组件通过 inject 获取。若多个祖先组件提供同名 key（如都用 theme），后代注入时会取到最近一层的值，容易覆盖或误用。
立即学习“前端免费学习笔记（深入）”；
- 推荐格式：
ui-theme、form-context、table-config，避免裸名theme或config - 组合式 API 中可用 Symbol 保证唯一性：
const ThemeSymbol = Symbol('theme')，再provide(ThemeSymbol, value) - 不要在多个无关组件中 provide 相同字符串 key，尤其跨业务模块时
事件总线需限定命名空间或改用 mitt
传统 Vue 实例事件总线（new Vue()）是全局的，任意组件都能 $emit 和 $on，极易因事件名重复引发逻辑错乱，且卸载时易漏掉 $off 导致内存泄漏。
- 改用轻量库
mitt，支持按频道订阅：const bus = mitt(); bus.on('user:update', handler) - 若仍用 Vue 实例，事件名强制加前缀，如
auth:login-success、cart:item-added - 组件销毁前务必手动
EventBus.$off('event-name')，或用beforeUnmount清理
