解决组件库事件名称冲突的关键是建立可落地的命名规则：采用“动词+名词+状态”三段式结构（如submitSuccess）、添加小写短横线前缀（如uploader-file-add）、禁用原生事件同名（改用triggerClick等），并配套事件校验、统一文档和IDE补全机制。

组件库中事件名称冲突，本质是命名缺乏约束和共识。解决的关键不是临时改名，而是建立可落地的命名规则，并在设计阶段就嵌入团队协作流程。

用“动词+名词+状态”结构明确语义

避免像 click、change 这类泛化名称，它们极易与原生事件或其它组件重叠。推荐采用三段式结构：动作（动词） + 主体（名词） + 状态/时机（可选）。例如：

• submitSuccess 比 success 更清晰——说明是表单提交成功，而非任意成功场景
• itemRemove 比 remove 更安全——明确操作对象是列表项，不与按钮或弹窗的 remove 混淆
• tabSwitch 比 switch 更准确——表明发生在 tab 切换时，而非开关控件的 toggle

统一前缀隔离组件域

为每个组件添加小写短横线前缀，形成天然命名空间。这不是为了炫技，而是让 IDE 自动补全和事件监听时一眼识别归属：

• uploader-file-add（上传组件新增文件）
• datepicker-range-change（日期范围选择器范围变更）
• tree-node-expand（树形控件节点展开）

前缀建议取自组件名拼音首字母或通用缩写（如 uploader 不用 up），确保可读性；全部小写+短横线，兼容 HTML 属性规范和 Vue/React 的事件绑定习惯。

禁用原生事件同名，强制加后缀或重构语义

直接使用 click、input、focus 等原生事件名，会导致 @click.native 失效、监听逻辑错乱、TypeScript 类型覆盖等问题。必须规避：

• 禁止导出 click 事件；如需暴露点击行为，改用 triggerClick 或 actionClick
• 输入类事件不用 input，改用 valueInput 或 textUpdate
• 若组件封装了原生 input 并需透传，显式命名为 nativeInput，并文档注明用途

配套机制比命名本身更重要

再好的命名规则，没有配套就容易失效。建议同步落地三项轻量机制：

• 事件注册校验：构建时扫描组件 emits 定义，对未匹配命名模式的事件抛 warning
• 统一事件文档页：每个组件的事件不再散落在 props 表格里，而是独立 tab，含触发时机、参数结构、典型用例
• VS Code 插件片段：输入 emits- 自动补全标准模板，如 emits-itemSelect → emits: ['itemSelect']

不复杂但容易忽略。命名体系不是写完就扔的文档，而是持续参与开发闭环的活规则。