Vue 3 组件命名冲突源于运行时解析模板时注册表存在多匹配项，需从注册机制、命名规范和工程化三方面解决：统一全局用 kebab-case、局部用 PascalCase 并保持文件名/变量名/name 一致，禁用自动导入插件默认推导，构建时扫描注册键名检测等价重叠，通用库启用前缀隔离，警告时优先查模板上下文与重复注册源。
Vue 3 中组件注册时出现命名冲突或覆盖，本质不是“名字重复了就报错”，而是运行时解析模板标签（如
理解 Vue 的组件名匹配逻辑
Vue 在运行时调用 resolveComponent("dialog-box") 时，会按顺序尝试三种键名匹配：
- 原始字符串：
"dialog-box" - 驼峰形式：
"dialogBox" - 帕斯卡形式：
"DialogBox"
只要注册表中存在任意两个不同组件对象对应这三种形式中的任一组合（比如同时注册了 dialogBox 和 DialogBox），就会触发冲突警告。这不是拼写错误，而是匹配策略带来的歧义。
统一注册方式与命名规范
避免手动混用多种注册风格是关键：
立即学习“前端免费学习笔记（深入）”；
- 全局注册统一用 kebab-case 字符串名，如
app.component('base-dialog', BaseDialog)，模板中只写<base-dialog> - 局部注册统一用 PascalCase 变量名，且保持文件名、变量名、
name选项三者一致，例如BaseDialog.vue导出时设defineOptions({ name: 'BaseDialog' }) - 禁用自动导入插件（如 unplugin-vue-components）的默认推导逻辑，或显式配置其生成规则，防止它把
BaseDialog.vue自动注册为baseDialog，又和你手动注册的BaseDialog冲突
工程化手段提前拦截
靠人工检查很难覆盖所有场景，建议引入自动化约束：
- 在构建流程中加入组件注册扫描脚本，遍历所有
app.component()和components: { }声明，收集所有注册键名，检测是否存在 kebab / camel / pascal 三者之间的等价重叠 - 使用
import.meta.glob批量注册时，强制要求文件名采用 kebab-case（如statistic-card.vue），并在注册逻辑中统一转为 kebab-case 键名，杜绝驼峰/帕斯卡形式混入 - 对通用组件库（如 PrimeVue、Element Plus）启用前缀，例如
app.use(PrimeVue, { componentPrefix: 'P' })，让<PButton>和项目自定义的<BaseButton>天然隔离
排查冲突的实用技巧
当警告出现时，别急着改名，先定位真实冲突源：
- 警告中显示的
Component "xxx"是模板里的标签名，不是文件名；去对应模板位置查这个标签的上下文 - 检查该组件是否被多次注册：一次在全局
main.ts，另一次又被某个父组件局部注册，或被自动导入插件又扫了一遍 - 若看到
Component <Anonymous>，说明某组件没设name选项，Vue 只能靠路径标识——立即补上defineOptions({ name: 'Xxx' })，便于后续追踪
