Analizador y validador de .env

Pega un archivo .env —o suéltalo sobre el cuadro— y recíbelo analizado, comprobado y explicado: cada clave en una tabla con su valor enmascarado, cada problema enumerado con su número de línea. Claves duplicadas, nombres no válidos, líneas que ni siquiera son asignaciones, valores vacíos que sobrescriben silenciosamente los valores predeterminados. Se ejecuta por completo en tu navegador y el archivo nunca se sube, porque un .env de producción es un paquete de secretos y debe tratarse como tal.

Qué se comprueba y por qué

El formato .env es una convención, no un estándar, y por eso los archivos se pudren en silencio. Todos los cargadores están de acuerdo en KEY=VALUE y en desacuerdo en todo lo demás: si se eliminan los prefijos export , si se respetan las comillas, si un comentario en línea termina un valor y —lo más peligroso— cuál de dos definiciones de la misma clave gana. Este validador aplica las reglas del denominador común e informa de los puntos en los que los cargadores divergen: una clave definida dos veces con ambos números de línea, un nombre que ninguna shell aceptaría, una comilla que se abre y nunca se cierra, una línea sin ningún signo igual. Los valores vacíos se señalan en lugar de fallar, porque KEY= es legal, pero sobrescribe cualquier valor predeterminado de la aplicación con una cadena vacía, que es la razón más común de que un servicio funcione en una máquina y no en otra.

El diseño de privacidad es la función. Un .env de producción concentra contraseñas de bases de datos, claves de API y secretos de sesión en un archivo pequeño, y el movimiento natural de depuración —pegarlo en algún sitio y pedir ayuda— es también la filtración. Los chats de IA, los sistemas de tickets y los canales de equipo conservan copias, a menudo con capacidad de búsqueda, a menudo para siempre. Por eso esta herramienta sigue la misma regla que el analizador de registros y el generador de certificados: la entrada sensible nunca sale del navegador, los valores se enmascaran en pantalla y las únicas exportaciones son archivos que tú descargas deliberadamente. El artículo complementario, los archivos env son el lugar donde los secretos van a filtrarse, cubre la higiene en torno al propio archivo: qué pertenece a él, qué no, y qué hacer cuando uno se escapa.

Preguntas frecuentes

¿Es seguro pegar aquí un .env de producción?

Sí: ese es el propósito de esta herramienta. El análisis se ejecuta por completo en tu navegador: no hay subida, no hay ida y vuelta al servidor, y nada de lo que pegas se transmite ni se almacena en ningún sitio. Los valores se enmascaran en pantalla por defecto, así que una pantalla compartida o una captura tampoco los filtran. No puede decirse lo mismo de pegar un .env en un chat de IA, un ticket o un mensaje de equipo, que conservan copias; el artículo sobre los archivos env y la filtración de secretos explica los hábitos más seguros.

¿Por qué importa una clave duplicada si gana la última?

Porque la persona que edita el archivo no sabe cuál gana. Cambia el valor de la línea 4, vuelve a desplegar y observa que no pasa nada: el cargador usó en silencio la línea 41. Peor aún, algunos marcos toman la primera definición y otros la última, así que el mismo archivo se comporta de forma distinta en una misma pila. Una clave, una línea, un valor: el validador enumera cada duplicado con ambos números de línea para que la línea muerta pueda eliminarse.

Mi aplicación lee una variable que no está en el .env. ¿Cómo las encuentro?

Pega tu código o configuración en el cuadro de uso. El analizador extrae cada nombre referenciado —process.env.X, process.env[’X’], import.meta.env.X, ${X} y $X— e informa en ambas direcciones: los nombres que el código referencia y el archivo nunca define (se convierten en undefined en tiempo de ejecución, normalmente en el peor momento) y las claves que el archivo define y nada referencia (configuración muerta que, sorprendentemente a menudo, sigue guardando secretos vigentes).

¿Qué cuenta como clave no válida?

Todo lo que no sea una letra o un guion bajo seguido de letras, dígitos y guiones bajos. Las claves que empiezan por un dígito, contienen guiones o puntos, o llevan espacios extraños son descartadas o alteradas por muchos cargadores y shells: un archivo que se carga limpiamente en bash puede fallar en un cargador de Node por exactamente esta razón. El validador las señala con el número de línea; la tabla de entradas sigue mostrando la fila para que veas qué se perdería.

¿Las exportaciones contienen los valores reales?

Sí. Las descargas JSON y YAML y el JSON copiado son la configuración real: el enmascarado es una protección de visualización, no una redacción de tus propios datos. Trata los archivos exportados exactamente igual que el propio .env: nunca los subas a un repositorio público, nunca los adjuntes a un ticket. Si necesitas una versión segura para compartir, comparte la captura enmascarada o la lista de claves.