Analizar un archivo dotenv en pares clave-valor

Los archivos dotenv parecen sencillos hasta que los valores contienen espacios, signos de comentario, asignaciones vacías o texto escapado. Este analizador convierte el contenido completo de un archivo .env en un objeto limpio de pares clave-valor mediante reglas sintácticas claras y previsibles. Ignora líneas vacías y comentarios, conserva el contenido entre comillas, reconoce comentarios en línea tras valores sin comillas e indica la línea exacta cuando una asignación no es válida. El resultado sirve para previsualizar configuraciones, migrarlas, validarlas y crear utilidades de desarrollo sin cargar variables en el entorno del proceso.

Proporcione el texto dotenv completo

Pegue o envíe el contenido del archivo .env en el campo text. Cada línea significativa debe contener una clave, un signo igual y un valor. Las claves comienzan con una letra ASCII o un guion bajo y pueden continuar con letras, dígitos o guiones bajos.

Se aceptan líneas vacías, y toda línea cuyo primer carácter no blanco sea una almohadilla se considera un comentario. Las asignaciones vacías, como CACHE_PREFIX=, son válidas y producen una cadena vacía. El analizador devuelve un objeto values con los pares procesados y un recuento de claves únicas.

Si una clave aparece varias veces, la última asignación sustituye a la anterior, como suele ocurrir al combinar fragmentos de configuración. La herramienta nunca escribe en el entorno de la máquina, expande variables, lee archivos ni contacta con servicios. Solo procesa el texto enviado, por lo que su comportamiento es seguro para previsualizaciones y reproducible en scripts de compilación, extensiones de editor, comprobadores y procesos de migración.

Comprenda las comillas, los escapes y los comentarios

En los valores sin comillas se elimina el espacio exterior. Una almohadilla inicia un comentario en línea únicamente cuando está precedida inmediatamente por un espacio, de modo que los fragmentos de URL y tokens como color=#fff permanecen intactos. Las comillas simples conservan literalmente el texto interior, incluidas las almohadillas y los espacios.

Las comillas dobles también los conservan, pero interpretan escapes habituales de barra inversa para salto de línea, retorno de carro, tabulación, comillas dobles y barra inversa. Tras cerrar las comillas solo se permiten espacios o un comentario. Estas reglas eliminan ambigüedades sin evaluar instrucciones de shell.

El analizador no interpola referencias como ${HOST}, no ejecuta sustituciones de comandos ni convierte cadenas como true y 8080 en booleanos o números. Todos los valores siguen siendo cadenas, porque los datos dotenv son textuales y cada aplicación debe decidir su propia conversión. Así no se pierden ceros iniciales, diferencias entre mayúsculas o valores intencionadamente vacíos.

Trate las entradas no válidas de forma explícita

Una línea que no esté vacía ni sea un comentario y que carezca de signo igual se rechaza en vez de omitirse silenciosamente. Lo mismo ocurre con una clave no válida, un valor entre comillas sin cierre o caracteres inesperados después de las comillas finales. Los mensajes de error incluyen el número de línea, empezando por uno, para que una persona o un editor automatizado localice el problema rápidamente.

Este comportamiento estricto resulta especialmente útil antes de desplegar: aceptar solo una parte de un archivo dañado puede ocultar una opción ausente hasta que la aplicación arranca con valores predeterminados inesperados. El análisis es determinista: el mismo contenido siempre genera el mismo objeto y el mismo error.