Extensión de VS Code que explica errores comunes de JavaScript, TypeScript y
Python en español claro, directo desde el editor — sin salir a buscar en
Google ni traducir mensajes técnicos en inglés.
Cómo probarla en tu computadora (modo desarrollo)
Necesitas tener instalado Node.js (v18 o superior) y VS Code.
Abre esta carpeta en VS Code.
Abre una terminal dentro de VS Code y corre:
npm install
npm run compile
Presiona F5 (o ve a "Run and Debug" → "Run Extension"). Esto abre
una segunda ventana de VS Code llamada "Extension Development Host",
con tu extensión ya cargada.
En esa ventana nueva, abre o crea un archivo .js, .ts o .py con
algún error a propósito, por ejemplo:
console.log(variableQueNoExiste);
Pasa el mouse sobre la línea subrayada en rojo — deberías ver, además
del mensaje normal de VS Code, un bloque con el título
"🇪🇸 Variable no definida" y la explicación en español.
También puedes poner el cursor en la línea con el error y ejecutar el
comando "Explica tus Errores: Explicar error en esta línea" desde
la paleta de comandos (Ctrl+Shift+P / Cmd+Shift+P).
Estructura del proyecto
src/extension.ts — punto de entrada: registra el hover provider y el
comando.
src/errorDictionary.ts — el diccionario de errores. Cada entrada tiene
un patrón (regex) que compara contra el mensaje real del error, más un
título, explicación y solución en español. Aquí es donde vas a pasar
más tiempo agregando cobertura — mientras más errores comunes cubras,
más útil se vuelve la extensión.
Cómo agregar un error nuevo al diccionario
Copia y pega un bloque como este dentro del arreglo diccionarioErrores
en src/errorDictionary.ts:
{
pattern: /texto o parte del mensaje de error en inglés/i,
titulo: "Nombre corto y claro del error",
explicacion: "Qué significa este error en términos sencillos.",
solucion: "Qué hacer para arreglarlo, paso a paso si se puede.",
},
