v-for renderiza una lista de elementos iterando sobre un array (u object/range). Siempre deberías emparejarlo con una :key única para que Vue pueda rastrear los elementos de manera eficiente.
<script setup>
import { ref } from "vue";
const items = ref([{ id: 1, name: "Apple" }, { id: 2, name: "Banana" }]);
</script>
<template>
<ul>
<li v-for="item in items" :key="item.id">{{ item.name }}</li>
</ul>
</template>
<template>
<li v-for="(item, index) in items" :key="item.id">{{ index }}: {{ item.name }}</li>
<li v-for="(value, key) in myObject" :key="key">{{ key }}: {{ value }}</li>
<span v-for="n in 5" :key="n">{{ n }}</span> <!-- range 1..5 -->
</template>
Vue utiliza la key para identificar qué elementos cambiaron, se agregaron o se eliminaron, para que pueda reutilizar y reordenar los nodos DOM existentes en lugar de reconstruirlos. Sin una key estable, Vue recurre a una estrategia de "in-place patch" que puede causar errores:
<!-- ❌ using index as key → wrong when the list reorders/filters -->
<li v-for="(item, i) in items" :key="i">
<input /> <!-- input state can attach to the WRONG item after reordering -->
</li>
<!-- ✅ stable unique id → Vue tracks each item correctly -->
<li v-for="item in items" :key="item.id">...</li>
Usando el índice del array como la key es un error común — cuando los elementos se reordenan, se insertan o se eliminan, el estado del component/DOM (como valores de entrada o estados de casillas de verificación) puede quedarse en la fila incorrecta.
<!-- ❌ avoid — ambiguous precedence -->
<li v-for="x in items" v-if="x.active">...</li>
<!-- ✅ filter in a computed, or wrap with <template v-for> -->
v-for es cómo renderizas listas dinámicas.
La :key no es prácticamente opcional: una key única y estable permite que el virtual DOM de Vue haga diff eficientemente y evita errores sutiles de desajuste de estado en reorden/filtrado.
Saber usar un id real (nunca el índice para listas dinámicas) y mantener v-for/v-if separados es esencial para listas correctas y de alto rendimiento.