#201 · Herramienta para desarrolladores

Comprobador de Vue

Revisa un componente Vue de archivo único (SFC) sin enviarlo a ningún servidor. El análisis separa template, script y style, señala bloques repetidos, directivas con expresiones vacías, bucles v-for sin una clave cercana y referencias de componentes que conviene comprobar. Está pensado para detectar fallos estructurales antes de pasar el archivo por el compilador o el linter del proyecto.

Datos de entrada

Componente Vue SFC
Espacio publicitario

Cómo usar esta herramienta para desarrolladores

  1. Pega el contenido completo de un archivo .vue.
  2. Pulsa “Comprobar Vue” o usa Ctrl/Cmd + Enter.
  3. Revisa cada aviso con su línea aproximada y la recomendación asociada.
  4. Corrige el SFC en tu proyecto y vuelve a comprobarlo si quieres confirmar la estructura.

Qué hace esta herramienta para desarrolladores

El comprobador hace una revisión estática del SFC. No compila Vue ni resuelve imports, pero permite localizar varios errores de estructura y convenciones que suelen aparecer antes de ejecutar el proyecto.

Se extraen los bloques principales con expresiones regulares acotadas, se inspeccionan directivas Vue y se comprueba el contexto inmediato de cada v-for para buscar una clave :key o v-bind:key.

Un resultado sin avisos significa que no se detectaron estas reglas concretas; no sustituye a vue-tsc, ESLint ni al compilador de Vue.

Ejemplo

Entrada de ejemplo

<template>
  <ul>
    <li v-for="item in items">{{ item.name }}</li>
  </ul>
</template>

<script setup>
const items = [{ name: 'Uno' }]
</script>

Ejecuta la herramienta para ver una salida generada a partir de este ejemplo.

Casos de uso

  • Revisión rápida de SFC recibidos en un pull request.
  • Detección de v-for sin claves estables.
  • Comprobación de bloques template/script/style repetidos.
  • Prevalidación antes de ejecutar herramientas del proyecto.

Consejos para obtener resultados fiables

  • Incluye el SFC completo para que el recuento de bloques sea útil.
  • Usa claves derivadas de identificadores estables, no del índice, cuando el orden pueda cambiar.
  • Si trabajas con TypeScript, valida después con vue-tsc.
  • No interpretes la ausencia de avisos como una compilación correcta.

Detalles del procesamiento

El análisis es local y no ejecuta el código del componente. Las posiciones se calculan a partir del texto original para facilitar la búsqueda del problema.

No evalúa tipos, macros personalizadas, imports, plugins de Vite ni transformaciones del compilador.

Preguntas frecuentes

¿Cómo detectar un v-for sin :key en un componente Vue?

El comprobador busca cada directiva v-for y revisa la misma etiqueta de apertura para comprobar si contiene :key o v-bind:key.

¿Este comprobador valida componentes Vue 2 y Vue 3?

Las reglas estructurales básicas sirven para ambos, pero no emula las diferencias de compilación entre versiones.

¿Puede comprobar errores de TypeScript dentro de <script setup>?

No. Señala estructura y patrones del SFC, pero los tipos deben validarse con vue-tsc o el compilador del proyecto.

¿Por qué marca como aviso una directiva Vue vacía?

Una expresión vacía en v-if, v-show, :prop o @evento suele indicar una edición incompleta y merece revisión.

¿El código Vue pegado se envía a un servidor?

No. El procesamiento principal se realiza en el navegador con JavaScript.

Resumen del módulo

ÁreaComportamiento
ComprobaciónBloques SFC y directivas
SalidaLista de avisos con línea
Ejecución100 % local en el navegador

Más herramientas de Frontend Frameworks

Explora utilidades relacionadas con Vue, React, Angular y otros frameworks frontend.

Ver Frontend Framework Tools