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 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” 直接传给内部的 ；
- 处理 focus/blur 等事件：如果有必要，记得把这些事件也透传出去，让用户能监听到。
这些细节做不到位的话，组件虽然能用，但在项目中体验会差一些。
基本上就这些了。v-model 虽然看起来简单，但在实际开发中非常常用，特别是做表单类组件时，掌握好它的用法能让你的组件更易用、更规范。
