Vue / 系统课时
父子组件数据流
父子组件数据流
父子组件通信最容易失控的地方,是子组件既读取父级数据又直接修改父级状态。Vue 3 更稳妥的做法是让 Props 负责“向下传值”,Emits 负责“向上报告事件”,把状态所有权留在父组件,从而形成可追踪的单向数据流。
学习目标
- 使用 TypeScript 为 Props 和 Emits 定义清晰的组件接口。
- 理解“父级持有状态、子级表达意图”的单向数据流。
- 避免直接修改 Props,并用事件完成受控更新。
单向数据流的职责边界
父组件拥有业务状态,并通过 Props 把当前值传给子组件;子组件把 Props 当作只读输入,根据用户操作发出事件;父组件收到事件后决定是否更新状态,再把新值重新传下去。这样每次状态变化都有明确来源,调试时不需要在多个组件之间追踪隐式写入。

用类型约束 Props 和 Emits
下面的计数器子组件只接收当前值,并在按钮点击时报告“增加多少”。defineProps 描述输入,defineEmits 描述允许发送的事件名和参数类型。
<script setup lang="ts">
const props = defineProps<{
count: number
step?: number
}>()
const emit = defineEmits<{
increment: [amount: number]
}>()
function handleIncrement() {
emit('increment', props.step ?? 1)
}
</script>
<template>
<button type="button" @click="handleIncrement">
当前值:{{ props.count }}
</button>
</template>预期结果
组件渲染一个按钮并显示传入的 count;点击按钮时不会直接修改 count,而是发出 increment 事件,并携带 step 或默认值 1。props.count 在子组件中是只读输入。即使某些写法能绕过类型检查,直接修改 Props 仍会破坏状态所有权,也可能在父组件下一次渲染时被覆盖。
由父组件决定如何更新
父组件接收事件后执行真正的状态变更。这里的更新策略很简单,但实际项目中还可以加入权限判断、最大值校验、接口请求或埋点,而无需把这些业务规则塞进子组件。
<script setup lang="ts">
import { ref } from 'vue'
import CounterButton from './CounterButton.vue'
const count = ref(0)
function increase(amount: number) {
count.value += amount
}
</script>
<template>
<CounterButton
:count="count"
:step="2"
@increment="increase"
/>
</template>预期结果
初始按钮显示“当前值:0”;每次点击后父组件把 count 增加 2,随后新的值通过 props 重新传给子组件,因此显示 2、4、6……事件表达意图而不是实现
事件名应描述子组件发生了什么或希望父组件处理什么,例如 submit、remove、increment,而不是把父组件内部实现写进事件名。子组件只负责报告意图,父组件决定状态是否真的变化,这种接口更容易复用。
当通信变成“传入一个值,子组件修改后同步给父组件”时,可以进一步使用 v-model 约定;但它本质上仍是 Props 加 Emits,而不是子组件直接获得父级状态的写权限。
父子通信设计得是否清晰,可以用一个问题判断:看到任意一次状态变化时,能否快速指出“谁拥有这个状态、谁发起了意图、谁最终执行了修改”。如果答案始终明确,组件职责通常就不会失控。