在 Vue 3 中,v-model 必须绑定 reactive 对象的属性(如 form.username),而非整个 reactive 对象;支持方括号动态访问(form[key])和 toRefs 解构,确保响应式双向绑定。

在 Vue 3 中,reactive 创建的对象本身不支持像 ref 那样直接用 v-model 绑定到表单元素上——但你可以轻松实现双向绑定,关键在于:用 v-model 绑定 reactive 对象的属性(即嵌套的响应式字段),而不是绑定整个 reactive 对象。
✅ 正确写法:v-model 直接指向 reactive 对象的属性
只要 reactive 对象的某个属性是基础类型(如 string、number、boolean),它天然就是响应式的,v-model 可以直接绑定该属性:
// setup()
const form = reactive({
username: '',
email: '',
agree: false
})
<p>// 模板中
<input v-model="form.username" placeholder="用户名"><input v-model="form.email" type="email"><input v-model="form.agree" type="checkbox"> 我已阅读并同意
</p>这样修改输入框时,form.username 等会自动更新;反之修改 form.username 的值(比如在 JS 中赋值),输入框也会同步刷新 —— 这就是标准的双向绑定。
⚠️ 常见误区:不要把 v-model 指向整个 reactive 对象
下面这种写法是错误且无效的:
<!-- ❌ 错误:v-model 不能绑定 reactive 对象本身 --> <input v-model="form">
因为 v-model 期望一个可读写的响应式“值”,而 form 是个对象引用,不是基础值。Vue 无法自动解包或代理整个对象作为 v-model 的目标。
? 进阶技巧:动态字段名绑定(如循环生成表单项)
如果字段名是变量(比如从数组动态生成),可用方括号语法 + v-model:
const form = reactive({
name: '',
age: 0,
city: ''
})
<p>const fields = ['name', 'age', 'city']</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill12458" title="vercel-react-best-practices"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20d79f23518.jpg" alt="vercel-react-best-practices" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill12458" title="vercel-react-best-practices" class="overflowclass">vercel-react-best-practices</a>
<p class="overflowclass">来自 Vercel Engineering 的 React 和 Next.js 性能优化指南。用于编写、审查或重构 React/Next.js 代码以确保最佳性</p>
</div>
<a rel="nofollow" href="/xiazai/skill12458" title="vercel-react-best-practices" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><p>// 模板中
</p><div v-for="key in fields" :key="key">
<label>{{ key }}:</label>
<input v-model="form[key]">
</div>
✅ 支持字符串索引访问,form[key] 在模板中是合法且响应式的(前提是 key 对应的属性已存在或已被初始化)。
? 小提示:若字段可能动态新增,建议提前在 reactive 中定义好初始值,或用 nextTick + set(不推荐)/ 更推荐用 ref 管理动态键,但多数场景预设字段即可。
? 补充:需要深度监听或 computed 衍生?用 toRefs 或 computed
如果要在模板中频繁解构使用(如 username, email),又想保持响应性,可用 toRefs:
const form = reactive({ username: '', email: '' })
const { username, email } = toRefs(form) // 转为 ref,可安全解构
<p>// 模板中可直接写
<input v-model="username"><input v-model="email"></p>或者配合 computed 做双向派生(例如格式化输入):
const form = reactive({ rawInput: '' })
const formattedInput = computed({
get() { return form.rawInput.trim().toUpperCase() },
set(val) { form.rawInput = val }
})
// <input v-model="formattedInput">不复杂但容易忽略:核心就是别绑对象本身,绑它的属性;动态字段用 form[key];需要解构就用 toRefs。这样 reactive + v-model 就完全胜任表单双向绑定。









