v-model 是 vue 中实现双向数据绑定的语法糖,其核心机制是结合 value 属性和 input 事件。1. 它通过将数据绑定到表单元素的 value 并监听 input 事件来更新数据,从而实现双向同步;2. 在自定义组件中,默认使用 value 和 input,但可通过 model 选项自定义 prop 和事件名;3. vue 3 支持多个 v-model,通过指定参数名实现多个值的双向绑定;4. 使用时应避免直接修改 props,而应通过触发事件通知父组件更新,以保持数据流清晰。理解这些原理有助于正确高效地使用 v-model 进行开发。

在 Vue 中,v-model 是实现双向数据绑定的一种便捷方式。它本质上是一个语法糖,结合了 value 属性和 input 事件,用于在表单元素(如 input、textarea)与数据之间建立同步关系。
基本原理:绑定 value + 触发 input
当你在一个 元素上使用 v-model="message" 时,Vue 实际上做了两件事:
- 把
message的值作为value绑定到输入框上; - 监听输入框的
input事件,并在触发时更新message的值。
也就是说,下面这段代码:
立即学习“前端免费学习笔记(深入)”;
等价于:
这样就实现了“输入变化更新数据”、“数据变化更新输入”的双向绑定效果。
在组件中使用 v-model:自定义组件如何支持
在开发自定义组件时,如果你想让它也支持 v-model,需要注意以下几点:
- 默认情况下,
v-model会把value作为 prop 传递,并通过input事件来更新父级数据; - 如果你想用别的名字而不是
value和input,可以在组件中使用model选项来自定义。
举个例子,如果你希望用 checked 和 change 来代替:
export default {
model: {
prop: 'checked',
event: 'change'
},
props: ['checked']
}然后你就可以这样使用:
这相当于:
多个 v-model?Vue 2 vs Vue 3
在 Vue 2 中,一个组件只能有一个 v-model,因为它是基于固定的 value 和 input 实现的。
而在 Vue 3 中,你可以给 v-model 指定参数名,从而实现多个双向绑定:
这就相当于同时绑定了两个不同的值,并分别监听对应的 update:title 和 update:content 事件。
注意事项:避免直接修改 props
在自定义组件中,如果你接收了一个 value 或者自定义的 prop(比如 checked),不要直接修改这个 prop,例如:
this.checked = false // ❌ 不推荐
正确的做法是触发对应的事件来通知父组件更新数据,保持数据流清晰。比如:
this.$emit('change', false)否则可能会导致状态混乱,调试困难。
基本上就这些。理解 v-model 的本质后,你会发现它并不复杂,但很容易在实际开发中忽略细节。










