v-model 是 vue 中用于表单元素和组件间建立双向数据绑定的指令，能实现输入内容与数据自动同步。其基本用法是绑定 input 或 textarea 的值，如 ，使 message 与输入框内容保持一致；在自定义组件中使用时，需通过 model 选项声明 prop 和 event，并用 $emit('input') 更新父组件数据；与 .sync 修饰符不同，v-model 只绑定一个值，而 .sync 支持多个属性的双向绑定；开发自定义表单组件时应支持 v-model、传递原生属性、处理事件透传，以提升组件易用性和兼容性。掌握 v-model 能显著提高表单类组件开发效率和规范性。
v-model 在 Vue 中是一个非常实用的指令，它主要用来在表单元素和组件之间建立双向数据绑定。简单来说，就是当你在输入框中输入内容时，对应的数据会自动更新；反过来，如果数据发生变化，输入框中的值也会同步变化。
这在开发表单功能时特别方便，比如你有一个输入框，想让它的内容和某个变量保持一致，用 v-model 就可以轻松实现。
一、v-model 的基本用法
最常见的使用场景是直接作用在 <input> 或 <textarea></textarea> 上：
立即学习“前端免费学习笔记（深入）”；
<input v-model="message">
<p>{{ message }}</p>上面这段代码的意思是：输入框的内容和 message 这个变量始终保持一致。用户输入的时候，message 自动更新；如果你在 JS 中修改了 message，输入框的内容也会跟着变。
除了文本输入，v-model 也适用于复选框、单选按钮等表单控件，用法类似，只是绑定的值类型会有所不同。
二、如何在自定义组件中使用 v-model？
Vue 的组件默认不支持 v-model，但我们可以手动模拟它的行为。
一个标准的做法是：父组件通过 v-model 绑定一个值到子组件，子组件通过 model 选项声明这个绑定，并通过 $emit('input') 来通知父组件更新数据。
举个例子，我们来写一个简单的自定义输入组件：
<!-- 子组件 MyInput.vue -->
<template>
<input :value="value" @input="$emit('input', $event.target.value)">
</template>
<script>
export default {
model: {
prop: 'value',
event: 'input'
},
props: ['value']
}
</script>然后在父组件里这样使用：
<MyInput v-model="message" />
这样就实现了和原生 input 一样的双向绑定效果。
三、v-model 和 .sync 修饰符的区别
有些同学可能会混淆 v-model 和 .sync 修饰符，这里简单说一下它们的不同点：
-
v-model是一种语法糖，只能绑定一个值（通常是value+input事件）。 -
.sync是用来处理多个属性的双向绑定，适合需要同步多个 prop 的情况。
例如：
<MyComponent :title.sync="pageTitle" />
这时候子组件要触发 update:title 事件才能更新父组件的数据。
所以，如果你只需要同步一个值，优先用 v-model；如果是多个值，可以用 .sync 或者直接用 emit 手动控制。
四、自定义表单组件的小技巧
有时候我们会封装一些复杂的表单组件，比如带下拉选择的时间输入、带格式校验的输入框等等。这种情况下，为了让组件能更好地融入 Vue 的生态，建议做到以下几点：
- 支持 v-model：让使用者能像操作普通 input 一样使用你的组件；
-
传递原生属性：比如
placeholder、disabled、readonly等，可以通过v-bind="$attrs"直接传给内部的<input>； - 处理 focus/blur 等事件：如果有必要，记得把这些事件也透传出去，让用户能监听到。
这些细节做不到位的话，组件虽然能用，但在项目中体验会差一些。
基本上就这些了。v-model 虽然看起来简单，但在实际开发中非常常用，特别是做表单类组件时，掌握好它的用法能让你的组件更易用、更规范。
