在 Vue 3 项目里封装表单组件是很常见的需求。比如你写了一个 `MyInput` 组件，内部用 `<input>` 接收用户输入，然后通过 `v-model` 让父组件拿到值。看起来没问题，但实际运行时经常出现一个让人困惑的现象：每输入一个字符，输入框就失去焦点，必须重新点击才能继续输入。这个问题在开发搜索框、表单、聊天输入框时都会遇到。根本原因通常不在输入框本身，而在于组件渲染时组件的身份发生了变化。Vue 在更新 DOM 时，如果发现新旧节点的组件类型不同，或者 `key` 发生变化，会直接销毁旧组件并创建新组件，输入框自然就重新挂载了，焦点也随之丢失。这篇文章会从 Vue 的 patch 过程讲起，结合几个真实场景，说明为什么在模板里写了内联组件、动态组件、或者 `v-if` 切换时容易出现这个问题，以及如何通过稳定组件引用、合理使用 `key` 和 `v-show` 来避免输入框失焦。

先看一个最典型的例子。假设我们有一个简单的输入组件：

```vue

<template>
 <input
 :value="modelValue"
 @input="$emit('update:modelValue', $event.target.value)"
 />
</template>

<script setup>
defineProps(['modelValue'])
defineEmits(['update:modelValue'])
</script>
```

父组件这样用它：

```vue
<template>
 <MyInput v-model="text" />
</template>

<script setup>
import { ref } from 'vue'
import MyInput from './MyInput.vue'

const text = ref('')
</script>
```

这个写法本身没有问题，输入框不会失焦。真正出问题的是下面这种写法：

```vue
<template>
 <component :is="MyInput" v-model="text" />
</template>
```

或者更隐蔽的，在循环里用索引作为 key：

```vue
<template>
 <MyInput
 v-for="(item, index) in list"
 :key="index"
 v-model="item.value"
 />
</template>
```

当 `list` 的顺序发生变化，或者你在列表头部插入新项时，`index` 作为 key 会导致 Vue 复用错误的组件实例，输入框的内容和焦点都会错乱。

还有一种情况是在模板里直接写内联组件定义：

```vue
<template>
 <component :is="{ template: '<input />' }" v-model="text" />
</template>
```

每次渲染父组件时，`{ template: '<input />' }` 都是一个新对象。Vue 会认为组件类型变了，于是卸载旧组件、挂载新组件，输入框每次都会重新创建，焦点丢失就是必然的。

要确认是不是这个原因，可以在 `MyInput` 的 `onMounted` 和 `onUnmounted` 里打日志：

```js
import { onMounted, onUnmounted } from 'vue'

onMounted(() => console.log('mounted'))
onUnmounted(() => console.log('unmounted'))
```

如果每输入一个字符就打印一次 `unmounted` 和 `mounted`，说明组件确实在反复销毁重建。

解决思路是让 Vue 在更新时能够复用同一个组件实例。对于动态组件，把组件定义提取到外面，不要写在模板里：

```vue
<script setup>
import MyInput from './MyInput.vue'
const currentComponent = MyInput
</script>

<template>
 <component :is="currentComponent" v-model="text" />
</template>
```

对于列表渲染，使用稳定且唯一的 id 作为 key，而不是 index：

```vue
<MyInput
 v-for="item in list"
 :key="item.id"
 v-model="item.value"
/>
```

如果确实需要在两个组件之间切换，但又想保留输入框的状态和焦点，可以用 `v-show` 代替 `v-if`，或者用 `<KeepAlive>` 包裹动态组件：

```vue
<KeepAlive>
 <component :is="currentComponent" v-model="text" />
</KeepAlive>
```

`KeepAlive` 会缓存不活跃的组件实例，切换时不会销毁，输入框的 DOM 和焦点状态都能保留。但要注意，`KeepAlive` 只应该用在确实需要缓存的场景，否则会带来额外的内存开销。

另一个容易忽略的点是 `v-model` 在自定义组件上的编译结果。Vue 3 中 `v-model` 会被展开成 `:modelValue` 和 `@update:modelValue`。如果父组件在每次渲染时都创建一个新的内联函数，比如 `@update:modelValue="val => text = val"`，这本身不会导致组件销毁，但会让子组件的 props 每次都是新的函数引用，可能触发不必要的更新。如果子组件内部用了 `watch` 监听这个函数，就会频繁触发。更好的做法是使用 `v-model` 的语法糖，或者把处理函数定义在 `setup` 里。

在实际项目里，我还遇到过一种因为 `key` 使用不当导致的失焦。比如在一个可编辑表格中，每一行是一个自定义输入组件，key 绑定了行数据的某个字段。当用户编辑这个字段时，key 发生变化，Vue 认为这是一个新组件，于是销毁重建，输入框立刻失去焦点。这种场景下，key 应该绑定行数据的唯一标识，而不是会被用户修改的字段。

排查这类问题时，Vue Devtools 很有用。打开 Devtools 的 Components 面板，勾选“Highlight updates”，然后在输入框里打字。如果每次输入都看到组件树里对应的组件闪烁，说明它在重新渲染。如果整个组件被替换，那就是销毁重建了。

最后提一下 `defineModel`。Vue 3.4 引入了 `defineModel` 宏，可以更简洁地实现自定义组件的 `v-model`：

```vue

<template>
 <input v-model="model" />
</template>

<script setup>
const model = defineModel()
</script>
```

父组件照常使用 `v-model`。这个宏在编译后会生成 `modelValue` prop 和 `update:modelValue` 事件，写法更干净，但并不会改变组件更新和销毁的底层逻辑。如果组件本身因为 key 或动态类型问题被重建，输入框依然会失焦。所以重点还是放在保持组件实例的稳定性上。
 推荐查看天气：https://www.0dtq.com/jinning/10tian.html
 推荐查看天气：https://www.0dtq.com/jinning/15tian.html
 推荐查看天气：https://www.0dtq.com/jinning/40tian.html
 推荐查看天气：https://www.0dtq.com/fumin/
 推荐查看天气：https://www.0dtq.com/fumin/zuotian.html
 推荐查看天气：https://www.0dtq.com/fumin/7tian.html
 推荐查看天气：https://www.0dtq.com/fumin/10tian.html
 推荐查看天气：https://www.0dtq.com/fumin/15tian.html
 推荐查看天气：https://www.0dtq.com/fumin/40tian.html
 推荐查看天气：https://www.0dtq.com/kunmingyiliang/
 推荐查看天气：https://www.0dtq.com/kunmingyiliang/zuotian.html
 推荐查看天气：https://www.0dtq.com/kunmingyiliang/7tian.html
 推荐查看天气：https://www.0dtq.com/kunmingyiliang/10tian.html
 推荐查看天气：https://www.0dtq.com/kunmingyiliang/15tian.html
 推荐查看天气：https://www.0dtq.com/kunmingyiliang/40tian.html
 推荐查看天气：https://www.0dtq.com/shilin/
 推荐查看天气：https://www.0dtq.com/shilin/zuotian.html
 推荐查看天气：https://www.0dtq.com/shilin/7tian.html
 推荐查看天气：https://www.0dtq.com/shilin/10tian.html
 推荐查看天气：https://www.0dtq.com/shilin/15tian.html
 推荐查看天气：https://www.0dtq.com/shilin/40tian.html
 推荐查看天气：https://www.0dtq.com/songming/
 推荐查看天气：https://www.0dtq.com/songming/zuotian.html
 推荐查看天气：https://www.0dtq.com/songming/7tian.html
 推荐查看天气：https://www.0dtq.com/songming/10tian.html
 推荐查看天气：https://www.0dtq.com/songming/15tian.html
 推荐查看天气：https://www.0dtq.com/songming/40tian.html
 推荐查看天气：https://www.0dtq.com/luquan/
 推荐查看天气：https://www.0dtq.com/luquan/zuotian.html
 推荐查看天气：https://www.0dtq.com/luquan/7tian.html
 推荐查看天气：https://www.0dtq.com/luquan/10tian.html
 推荐查看天气：https://www.0dtq.com/luquan/15tian.html
 推荐查看天气：https://www.0dtq.com/luquan/40tian.html
 推荐查看天气：https://www.0dtq.com/xundian/
 推荐查看天气：https://www.0dtq.com/xundian/zuotian.html
 推荐查看天气：https://www.0dtq.com/xundian/7tian.html
 推荐查看天气：https://www.0dtq.com/xundian/10tian.html
 推荐查看天气：https://www.0dtq.com/xundian/15tian.html
 推荐查看天气：https://www.0dtq.com/xundian/40tian.html
 推荐查看天气：https://www.0dtq.com/anningshi/
 推荐查看天气：https://www.0dtq.com/anningshi/zuotian.html
 推荐查看天气：https://www.0dtq.com/anningshi/7tian.html
 推荐查看天气：https://www.0dtq.com/anningshi/10tian.html
 推荐查看天气：https://www.0dtq.com/anningshi/15tian.html
 推荐查看天气：https://www.0dtq.com/anningshi/40tian.html
 推荐查看天气：https://www.0dtq.com/qujing/
 推荐查看天气：https://www.0dtq.com/qujing/zuotian.html
 推荐查看天气：https://www.0dtq.com/qujing/7tian.html
 推荐查看天气：https://www.0dtq.com/qujing/10tian.html
 推荐查看天气：https://www.0dtq.com/qujing/15tian.html
 推荐查看天气：https://www.0dtq.com/qujing/40tian.html
 推荐查看天气：https://www.0dtq.com/qilin/
 推荐查看天气：https://www.0dtq.com/qilin/zuotian.html
 推荐查看天气：https://www.0dtq.com/qilin/7tian.html
 推荐查看天气：https://www.0dtq.com/qilin/10tian.html
 推荐查看天气：https://www.0dtq.com/qilin/15tian.html
 推荐查看天气：https://www.0dtq.com/qilin/40tian.html
 推荐查看天气：https://www.0dtq.com/malong/
 推荐查看天气：https://www.0dtq.com/malong/zuotian.html
 推荐查看天气：https://www.0dtq.com/malong/7tian.html
 推荐查看天气：https://www.0dtq.com/malong/10tian.html
 推荐查看天气：https://www.0dtq.com/malong/15tian.html
 推荐查看天气：https://www.0dtq.com/malong/40tian.html
 推荐查看天气：https://www.0dtq.com/luliang/
 推荐查看天气：https://www.0dtq.com/luliang/zuotian.html
 推荐查看天气：https://www.0dtq.com/luliang/7tian.html
 推荐查看天气：https://www.0dtq.com/luliang/10tian.html
 推荐查看天气：https://www.0dtq.com/luliang/15tian.html
 推荐查看天气：https://www.0dtq.com/luliang/40tian.html
 推荐查看天气：https://www.0dtq.com/shizong/
 推荐查看天气：https://www.0dtq.com/shizong/zuotian.html
 推荐查看天气：https://www.0dtq.com/shizong/7tian.html
 推荐查看天气：https://www.0dtq.com/shizong/10tian.html
 推荐查看天气：https://www.0dtq.com/shizong/15tian.html
 推荐查看天气：https://www.0dtq.com/shizong/40tian.html
 推荐查看天气：https://www.0dtq.com/luoping/
 推荐查看天气：https://www.0dtq.com/luoping/zuotian.html
 推荐查看天气：https://www.0dtq.com/luoping/7tian.html
 推荐查看天气：https://www.0dtq.com/luoping/10tian.html
 推荐查看天气：https://www.0dtq.com/luoping/15tian.html
 推荐查看天气：https://www.0dtq.com/luoping/40tian.html
 推荐查看天气：https://www.0dtq.com/fuyuan/
 推荐查看天气：https://www.0dtq.com/fuyuan/zuotian.html
 推荐查看天气：https://www.0dtq.com/fuyuan/7tian.html
 推荐查看天气：https://www.0dtq.com/fuyuan/10tian.html
 推荐查看天气：https://www.0dtq.com/fuyuan/15tian.html
 推荐查看天气：https://www.0dtq.com/fuyuan/40tian.html
 推荐查看天气：https://www.0dtq.com/huize/
 推荐查看天气：https://www.0dtq.com/huize/zuotian.html
 推荐查看天气：https://www.0dtq.com/huize/7tian.html
 推荐查看天气：https://www.0dtq.com/huize/10tian.html
 推荐查看天气：https://www.0dtq.com/huize/15tian.html
 推荐查看天气：https://www.0dtq.com/huize/40tian.html
 推荐查看天气：https://www.0dtq.com/zhanyi/
 推荐查看天气：https://www.0dtq.com/zhanyi/zuotian.html
 推荐查看天气：https://www.0dtq.com/zhanyi/7tian.html
 推荐查看天气：https://www.0dtq.com/zhanyi/10tian.html
 推荐查看天气：https://www.0dtq.com/zhanyi/15tian.html
 推荐查看天气：https://www.0dtq.com/zhanyi/40tian.html
 推荐查看天气：https://www.0dtq.com/xuanwei/
 推荐查看天气：https://www.0dtq.com/xuanwei/zuotian.html
 推荐查看天气：https://www.0dtq.com/xuanwei/7tian.html
 推荐查看天气：https://www.0dtq.com/xuanwei/10tian.html
 推荐查看天气：https://www.0dtq.com/xuanwei/15tian.html
 推荐查看天气：https://www.0dtq.com/xuanwei/40tian.html
 推荐查看天气：https://www.0dtq.com/yuxi/
 推荐查看天气：https://www.0dtq.com/yuxi/zuotian.html
 推荐查看天气：https://www.0dtq.com/yuxi/7tian.html
 推荐查看天气：https://www.0dtq.com/yuxi/10tian.html
 推荐查看天气：https://www.0dtq.com/yuxi/15tian.html
 推荐查看天气：https://www.0dtq.com/yuxi/40tian.html
 推荐查看天气：https://www.0dtq.com/hongta/
 推荐查看天气：https://www.0dtq.com/hongta/zuotian.html
 推荐查看天气：https://www.0dtq.com/hongta/7tian.html
 推荐查看天气：https://www.0dtq.com/hongta/10tian.html
 推荐查看天气：https://www.0dtq.com/hongta/15tian.html
 推荐查看天气：https://www.0dtq.com/hongta/40tian.html
 推荐查看天气：https://www.0dtq.com/jiangchuan/
 推荐查看天气：https://www.0dtq.com/jiangchuan/zuotian.html
 推荐查看天气：https://www.0dtq.com/jiangchuan/7tian.html
 推荐查看天气：https://www.0dtq.com/jiangchuan/10tian.html
 推荐查看天气：https://www.0dtq.com/jiangchuan/15tian.html
 推荐查看天气：https://www.0dtq.com/jiangchuan/40tian.html
 推荐查看天气：https://www.0dtq.com/chengjiang/
 推荐查看天气：https://www.0dtq.com/chengjiang/zuotian.html
 推荐查看天气：https://www.0dtq.com/chengjiang/7tian.html
 推荐查看天气：https://www.0dtq.com/chengjiang/10tian.html
 推荐查看天气：https://www.0dtq.com/chengjiang/15tian.html
 推荐查看天气：https://www.0dtq.com/chengjiang/40tian.html
 推荐查看天气：https://www.0dtq.com/tonghai/
 推荐查看天气：https://www.0dtq.com/tonghai/zuotian.html
 推荐查看天气：https://www.0dtq.com/tonghai/7tian.html
 推荐查看天气：https://www.0dtq.com/tonghai/10tian.html
 推荐查看天气：https://www.0dtq.com/tonghai/15tian.html
 推荐查看天气：https://www.0dtq.com/tonghai/40tian.html
 推荐查看天气：https://www.0dtq.com/huaning/
 推荐查看天气：https://www.0dtq.com/huaning/zuotian.html
 推荐查看天气：https://www.0dtq.com/huaning/7tian.html
 推荐查看天气：https://www.0dtq.com/huaning/10tian.html
 推荐查看天气：https://www.0dtq.com/huaning/15tian.html
 推荐查看天气：https://www.0dtq.com/huaning/40tian.html
 推荐查看天气：https://www.0dtq.com/yimen/
 推荐查看天气：https://www.0dtq.com/yimen/zuotian.html
 推荐查看天气：https://www.0dtq.com/yimen/7tian.html
 推荐查看天气：https://www.0dtq.com/yimen/10tian.html
 推荐查看天气：https://www.0dtq.com/yimen/15tian.html
 推荐查看天气：https://www.0dtq.com/yimen/40tian.html
 推荐查看天气：https://www.0dtq.com/eshan/
 推荐查看天气：https://www.0dtq.com/eshan/zuotian.html
 推荐查看天气：https://www.0dtq.com/eshan/7tian.html
 推荐查看天气：https://www.0dtq.com/eshan/10tian.html
 推荐查看天气：https://www.0dtq.com/eshan/15tian.html
 推荐查看天气：https://www.0dtq.com/eshan/40tian.html
 推荐查看天气：https://www.0dtq.com/xinping/
 推荐查看天气：https://www.0dtq.com/xinping/zuotian.html
 推荐查看天气：https://www.0dtq.com/xinping/7tian.html
 推荐查看天气：https://www.0dtq.com/xinping/10tian.html
 推荐查看天气：https://www.0dtq.com/xinping/15tian.html
 推荐查看天气：https://www.0dtq.com/xinping/40tian.html
 推荐查看天气：https://www.0dtq.com/yuanjiang/
 推荐查看天气：https://www.0dtq.com/yuanjiang/zuotian.html
 推荐查看天气：https://www.0dtq.com/yuanjiang/7tian.html
 推荐查看天气：https://www.0dtq.com/yuanjiang/10tian.html
 推荐查看天气：https://www.0dtq.com/yuanjiang/15tian.html
 推荐查看天气：https://www.0dtq.com/yuanjiang/40tian.html
 推荐查看天气：https://www.0dtq.com/baoshan/
 推荐查看天气：https://www.0dtq.com/baoshan/zuotian.html
 推荐查看天气：https://www.0dtq.com/baoshan/7tian.html
 推荐查看天气：https://www.0dtq.com/baoshan/10tian.html
 推荐查看天气：https://www.0dtq.com/baoshan/15tian.html
 推荐查看天气：https://www.0dtq.com/baoshan/40tian.html
 推荐查看天气：https://www.0dtq.com/longyang/
 推荐查看天气：https://www.0dtq.com/longyang/zuotian.html
 推荐查看天气：https://www.0dtq.com/longyang/7tian.html
 推荐查看天气：https://www.0dtq.com/longyang/10tian.html
 推荐查看天气：https://www.0dtq.com/longyang/15tian.html
 推荐查看天气：https://www.0dtq.com/longyang/40tian.html
 推荐查看天气：https://www.0dtq.com/shidian/
 推荐查看天气：https://www.0dtq.com/shidian/zuotian.html
 推荐查看天气：https://www.0dtq.com/shidian/7tian.html
 推荐查看天气：https://www.0dtq.com/shidian/10tian.html
 推荐查看天气：https://www.0dtq.com/shidian/15tian.html
 推荐查看天气：https://www.0dtq.com/shidian/40tian.html
 推荐查看天气：https://www.0dtq.com/tengchong/
 推荐查看天气：https://www.0dtq.com/tengchong/zuotian.html
 推荐查看天气：https://www.0dtq.com/tengchong/7tian.html
 推荐查看天气：https://www.0dtq.com/tengchong/10tian.html
 推荐查看天气：https://www.0dtq.com/tengchong/15tian.html
 推荐查看天气：https://www.0dtq.com/tengchong/40tian.html
 推荐查看天气：https://www.0dtq.com/longling/
 推荐查看天气：https://www.0dtq.com/longling/zuotian.html
 推荐查看天气：https://www.0dtq.com/longling/7tian.html
 推荐查看天气：https://www.0dtq.com/longling/10tian.html
 推荐查看天气：https://www.0dtq.com/longling/15tian.html
 推荐查看天气：https://www.0dtq.com/longling/40tian.html
 推荐查看天气：https://www.0dtq.com/changning/
 推荐查看天气：https://www.0dtq.com/changning/zuotian.html
 推荐查看天气：https://www.0dtq.com/changning/7tian.html
 推荐查看天气：https://www.0dtq.com/changning/10tian.html
 推荐查看天气：https://www.0dtq.com/changning/15tian.html

在 Vue 3 项目里封装表单组件是很常见的需求。比如你写了一个 MyInput 组件，内部用 <input> 接收用户输入，然后通过 v-model 让父组件拿到值。看起来没问题，但实际运行时经常出现一个让人困惑的现象：每输入一个字符，输入框就失去焦点，必须重新点击才能继续输入。这个问题在开发搜索框、表单、聊天输入框时都会遇到。根本原因通常不在输入框本身，而在于组件渲染时组件的身份发生了变化。Vue 在更新 DOM 时，如果发现新旧节点的组件类型不同，或者 key 发生变化，会直接销毁旧组件并创建新组件，输入框自然就重新挂载了，焦点也随之丢失。这篇文章会从 Vue 的 patch 过程讲起，结合几个真实场景，说明为什么在模板里写了内联组件、动态组件、或者 v-if 切换时容易出现这个问题，以及如何通过稳定组件引用、合理使用 key 和 v-show 来避免输入框失焦。

Vue 3 中 v-model 绑定自定义组件时，为什么输入框会失去焦点？

在 Vue 3 项目里封装表单组件是很常见的需求。比如你写了一个 MyInput 组件，内部用 <input> 接收用户输入，然后通过 v-model 让父组件拿到值。看起来没问题，但实际运行时经常出现一个让人困惑的现象：每输入一个字符，输入框就失去焦点，必须重新点击才能继续输入。这个问题在开发搜索框、表单、聊天输入框时都会遇到。根本原因通常不在输入框本身，而在于组件渲染时组件的身份发生了变化。V

前端

编程语言

Vue3表单组件输入失焦源于组件身份变化导致销毁重建。动态组件内联定义、v-for用index作key、key绑定可变字段是常见诱因。通过提取组件引用、使用稳定唯一key、v-show替代v-if或KeepAlive缓存可保持组件实例稳定，避免输入框焦点丢失。

代码解释

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Vue 3 中 v-model 绑定自定义组件时，为什么输入框会失去焦点？-腾讯云开发者社区-腾讯云

Vue 3 中 v-model 绑定自定义组件时，为什么输入框会失去焦点？

Vue 3 中 v-model 绑定自定义组件时，为什么输入框会失去焦点？

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐