v-model 直接绑定 ref 或 reactive 数据实现双向绑定最简洁;子组件需用 defineProps 和 defineEmits 支持 v-model;多参数如 v-model:checked 本质是 :checked + @update:checked;避免响应式丢失和类型推导问题。

用 v-model 直接绑定响应式变量
在 script setup 中,表单双向绑定最简洁的方式就是直接用 v-model 绑定 ref 或 reactive 创建的响应式数据。不需要手动写事件监听和赋值逻辑。
例如输入框绑定字符串:
- 定义
const name = ref(''),模板中写 - 定义
const form = reactive({ email: '', password: '' }),模板中写
注意:v-model 对 ref 自动解包(读写 .value),对 reactive 对象属性则直接操作,无需额外处理。
子组件实现 v-model 的自定义绑定
当封装表单子组件(如自定义输入框)时,需配合 defineProps 和 defineEmits 实现 v-model 支持。
默认 v-model 绑定的是 modelValue prop 和 update:modelValue 事件:
从零开始编排 SpringBoot+Vue 全栈项目工作流,适用于新建全栈项目或完整脚手架请求,触发后依次调用 product‑spec‑builder(需求调研)等模块。
- 子组件声明:
const props = defineProps({ modelValue: String }) - 声明触发更新的 emit:
const emit = defineEmits(['update:modelValue']) - 模板中:
emit('update:modelValue', e.target.value)">
这样父组件就能像使用原生 input 一样:
多参数 v-model(如 v-model:checked)
支持为不同类型的表单控件指定不同的 v-model 参数名,比如复选框常用 v-model:checked。
- 子组件接收:
defineProps({ checked: Boolean }) - 触发事件:
defineEmits(['update:checked']) - 父组件调用:
本质是把 v-model:checked="xxx" 编译为 :checked="xxx" @update:checked="xxx = $event"。
避免常见坑:响应式丢失与类型推断
双向绑定失效常因以下原因:
- 用普通变量(
let name = '')代替ref('')—— 没有响应性,v-model 不生效 - 解构 reactive 对象后赋值,如
const { title } = form再title = 'new'—— 破坏响应式连接,应始终通过form.title = 'new'修改 - TypeScript 下未给 defineProps 正确标注类型,导致 IDE 无法推导 v-model 绑定字段类型,建议用泛型写法:
defineProps()
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!









