最标准、最推荐的方式是通过自定义事件:子组件用$emit(Vue 2)或defineEmits+emit(Vue 3)触发事件并传参,父组件用@事件名监听接收,事件名建议短横线命名,需拼写一致且遵守单向数据流原则。

Vue 中子组件向父组件传数据,最标准、最推荐的方式就是用自定义事件。核心就两点:子组件 $emit 触发事件并带数据,父组件用 @事件名 监听并接收。
子组件触发自定义事件
在子组件内部,调用 this.$emit()(Vue 2)或 emit()(Vue 3 setup)来广播一个你命名的事件,并附上要传递的数据:
- 事件名建议用短横线分隔(如
user-submit),避免大驼峰,更符合 HTML 原生事件习惯 - 可以传一个值,也可以传多个(数组或对象更清晰),比如:
this.$emit('data-ready', { id: 1, name: '张三' }) - Vue 3 的
<script setup></script>中必须先声明事件:const emit = defineEmits(['data-ready'])
父组件监听并处理数据
父组件在使用子组件标签时,用 @事件名 绑定一个方法,该方法的参数就是子组件传来的数据:
- 写法等价于:
v-on:data-ready="handleData"或简写为@data-ready="handleData" - 方法中直接接收参数,例如:
handleData(payload) { this.userInfo = payload } - 如果子组件一次传多个参数,父组件方法形参顺序需严格对应,或统一用对象封装避免错位
常见误区与注意事项
实际开发中容易踩坑的地方:
立即学习“前端免费学习笔记(深入)”;
- 事件名拼写不一致(子组件
$emit('submit'),父组件却写@submint)→ 控制台无报错但不触发 - Vue 3 中漏写
defineEmits声明 → 开发模式下会警告,且 TypeScript 类型推导失效 - 误在子组件里直接修改 props 数据 → 违反单向数据流,应通过事件通知父组件去改
- 把自定义事件和原生 DOM 事件混淆(如
@click是原生点击,@my-event才是自定义)
补充:.sync 和 v-model 是语法糖
像 :model-value.sync 或 v-model 这类写法,底层仍是基于自定义事件实现的:
-
v-model="value"等价于:model-value="value" @update:model-value="val => value = val" - 本质还是子组件
$emit('update:model-value', newValue),父组件监听后更新自身数据 - 所以理解好基础的
$emit + @,才能真正掌握所有双向绑定机制


















