Parser de Archivos .env — Validar y Formatear

¿Qué es el Parser de Archivos .env?

El .env File Parser & Formatter es una herramienta basada en el navegador para trabajar con archivos de variables de entorno. Analiza el contenido KEY=VALUE para detectar errores de sintaxis, identificar claves duplicadas y mostrar estadísticas del archivo; convierte sus variables a JSON, YAML, Docker --env-file o formato docker-compose.yml con un solo clic; y combina dos archivos .env con resolución interactiva de conflictos cuando la misma clave aparece en ambos archivos con valores diferentes.

Úselo cuando necesite auditar un archivo de entorno antes de desplegar, compartir configuración con un compañero de equipo en un formato diferente, combinar un .env base con una sobreescritura específica del entorno, o simplemente ordenar un archivo largo alfabéticamente para que sea más fácil de revisar. Todo se ejecuta en el navegador: sus secretos nunca tocan un servidor.

Características Principales

• Analizar pares KEY=VALUE con soporte para valores entre comillas y multilínea — los valores entre comillas simples y dobles se descomillan automáticamente; los comentarios en línea después de valores sin comillas se eliminan.
• Detectar claves duplicadas con insignias de advertencia — cada clave que aparezca más de una vez se marca en el panel de Validación con un icono de advertencia amarillo.
• Validar sintaxis: = faltante, claves vacías, caracteres inválidos — el parser impone que las claves deben comenzar con una letra o guion bajo y contener solo caracteres alfanuméricos y guiones bajos (/^[a-zA-Z_][a-zA-Z0-9_]*$/). Cada infracción informa el número de línea específico.
• Ordenar variables alfabéticamente — el botón Ordenar reescribe el área de texto de entrada con variables en orden lexicográfico ascendente, reemplazando el contenido original.
• Convertir a formato JSON — produce un objeto JSON bien formateado con todas las claves y valores de variables.
• Convertir a formato YAML — envuelve automáticamente los valores entre comillas dobles cuando el valor contiene caracteres especiales de YAML (:, #, {, }, [, ], ,, &, *, !, |, >, ', ", %, @, ` `), cadenas similares a booleanos (true, false, yes, no, null`), cadenas puramente numéricas o valores vacíos.
• Convertir a formato Docker --env-file — genera pares KEY=VALUE sin comillas, como lo requiere docker run --env-file.
• Convertir a bloque de entorno docker-compose.yml — envuelve la salida en un bloque YAML environment: con elementos de lista (- KEY=VALUE), listo para pegar en una definición de servicio docker-compose.yml.
• Combinar dos archivos .env con detección y resolución de conflictos — áreas de texto en paralelo; los conflictos se listan con ambos valores para que pueda elegir cuál prevalece antes de aplicar.
• Mostrar estadísticas: recuento de variables, comentarios, líneas vacías — cuatro contadores se muestran después del análisis: Variables, Comentarios, Líneas vacías y Duplicados.
• Soporte para carga de archivos — cargue archivos .env, .env.* o .txt directamente desde el disco.
• Procesamiento 100% del lado del cliente — sus secretos nunca abandonan su navegador.

Cómo Usar el Parser de Archivos .env

Paso 1: Ingresar o Cargar su Contenido .env

Cambie entre los dos modos usando las pestañas Analizar y Validar y Combinar en la parte superior de la herramienta.

En el modo Analizar, pegue su contenido .env directamente en el área de texto de entrada a la izquierda, o haga clic en Cargar para cargar un archivo desde el disco (acepta archivos .env, .env.* y .txt). Si desea explorar el comportamiento de la herramienta sin sus propios datos, haga clic en Cargar Ejemplo para llenar la entrada con un archivo de demostración que incluye comentarios, valores entre comillas, una clave duplicada y una línea intencionalmente mal formada.

Ejemplo de entrada:

# Application Configuration
APP_NAME=my-awesome-app
APP_ENV=production
APP_PORT=3000

# Database
DATABASE_URL="postgres://user:pass@localhost:5432/mydb"
DATABASE_POOL_SIZE=10

# Duplicate key (triggers warning)
APP_PORT=8080

# Invalid line (triggers error)
MISSING_EQUALS

Paso 2: Revisar las Estadísticas y el Panel de Validación

Después de escribir o pegar contenido, aparecen dos paneles debajo del editor:

Estadísticas muestra cuatro contadores en una cuadrícula:

• Variables — recuento de entradas KEY=VALUE válidas
• Comentarios — líneas que comienzan con #
• Líneas vacías — líneas en blanco
• Duplicados — claves que aparecen más de una vez (el contador se vuelve amarillo cuando no es cero)

Validación lista cada problema encontrado:

• Las claves duplicadas aparecen con un icono de triángulo amarillo: "Duplicate key: APP_PORT"
• Los errores de sintaxis aparecen con un icono de X roja, citando la línea exacta: "Line 14: Missing '=' sign"
• Si no hay problemas, una marca de verificación verde confirma: "No issues found"

Paso 3: Elegir un Formato de Salida

El selector de formato del panel derecho ofrece cinco opciones:

Haga clic en cualquier botón para cambiar la salida instantáneamente. Todos los formatos excluyen líneas de comentarios y líneas vacías: solo se incluyen entradas de variables válidas.

El formato de salida .env también normaliza las comillas: los valores que contienen espacios, # o " se envuelven automáticamente entre comillas dobles con las comillas dobles internas escapadas.

Paso 4: Ordenar y Copiar

Haga clic en Ordenar para reescribir el área de texto de entrada con variables en orden alfabético. Esto modifica la entrada en su lugar, de modo que el contenido ordenado se convierte en la nueva fuente para el análisis y la salida.

Haga clic en Copiar en el encabezado del panel de salida para copiar el resultado formateado al portapapeles.

Paso 5: Combinar Dos Archivos .env (Opcional)

Cambie a la pestaña Combinar. Pegue o cargue un archivo .env en el área de texto Archivo A y otro en Archivo B, luego haga clic en Combinar Archivos.

• Si los dos archivos no tienen claves en conflicto (la misma clave con valores diferentes), la combinación se completa inmediatamente y el resultado aparece en la entrada de la pestaña Analizar para su posterior edición.
• Si existen conflictos, un panel de Resolución de Conflictos lista cada clave en conflicto con ambos valores mostrados como botones. Haga clic en el botón del valor que desea mantener (A o B), luego haga clic en Aplicar Combinación para combinar los archivos usando sus selecciones.

Ejemplos Prácticos

Auditoría de un .env de Producción Antes del Despliegue

Pegue el archivo de entorno de producción y observe el panel de Validación. Incluso un solo error "Missing '=' sign" o advertencia de clave duplicada puede indicar un error de copiar y pegar que causaría un fallo de configuración en tiempo de ejecución. Los contadores de Estadísticas le dan un recuento rápido para cotejar con su lista de variables esperadas.

Conversión para Docker

Tiene un archivo .env que funciona con dotenv en Node.js pero necesita pasarlo a un contenedor Docker. Seleccione Docker --env-file para usar con docker run --env-file .env, o seleccione docker-compose.yml para obtener un bloque environment: listo para usar:

environment:
  - APP_NAME=my-awesome-app
  - APP_ENV=production
  - DATABASE_POOL_SIZE=10

Pegue el bloque directamente en su definición de servicio.

Combinación de Archivos Base y de Sobreescritura

Su proyecto tiene .env.base con valores predeterminados compartidos y .env.local con sobreescrituras específicas del desarrollador. Cargue .env.base en Archivo A y .env.local en Archivo B, haga clic en Combinar Archivos, resuelva cualquier conflicto eligiendo el valor de sobreescritura local, luego copie la salida combinada como su .env de trabajo.

Consejos y Buenas Prácticas

Cargue archivos en lugar de pegar configuraciones largas. El botón de carga de archivos acepta formatos .env, .env.* y .txt. Esto evita los límites de tamaño del portapapeles y la corrupción accidental por espacios al final que puede ocurrir al copiar desde terminales.

Ordene antes de comparar. Si está comparando dos archivos de entorno manualmente, ordene ambos primero. El botón Ordenar normaliza el orden para que su herramienta de comparación pueda encontrar cambios significativos en lugar de ruido por diferentes ordenamientos de variables.

La salida YAML pone entre comillas automáticamente los valores similares a booleanos. El formateador detecta cadenas como true, false, yes, no y null y las envuelve entre comillas dobles. Esto evita que los parsers YAML interpreten FEATURE_FLAG=true como un booleano true en lugar de la cadena "true".

El formato de salida .env vuelve a poner entre comillas los valores con espacios. Si su entrada tiene SECRET_KEY=my secret with spaces, la salida .env la renderizará como SECRET_KEY="my secret with spaces". Esto es seguro para copiarlo de vuelta en cualquier cargador compatible con dotenv.

Los comentarios en línea sobre valores sin comillas se eliminan. Una línea como APP_PORT=3000 # HTTP port analizará el valor como 3000, descartando el comentario en línea. Los valores entre comillas como DESCRIPTION="hello # world" preservan el # como parte del valor.

Problemas Comunes y Solución de Problemas

"Line N: Missing '=' sign" — La línea tiene contenido pero no tiene signo de igual. Este es el error más común al pegar declaraciones de exportación de shell como export APP_NAME=foo. Elimine la palabra clave export antes de pegar.

"Line N: Empty key" — Una línea comienza con =, como =value. El parser requiere una clave no vacía antes del signo de igual.

"Line N: Invalid key 'MY-KEY'" — Los guiones no están permitidos en las claves de variables de entorno según el estándar POSIX, y este parser impone ^[a-zA-Z_][a-zA-Z0-9_]*$. Reemplace los guiones con guiones bajos: MY_KEY.

Advertencia de clave duplicada pero los valores son iguales — El parser marca todas las claves que aparecen más de una vez, independientemente de si los valores difieren. Elimine la línea redundante de la entrada.

El botón Combinar está desactivado — Tanto el Archivo A como el Archivo B deben tener contenido. El botón está deshabilitado si cualquier área de texto está vacía.

La salida YAML tiene comillas inesperadas — Los valores que son puramente numéricos o coinciden con literales booleanos (true, false, yes, no, null) se ponen entre comillas para preservar su tipo de cadena. Este es el comportamiento YAML intencional y correcto.

Privacidad y Seguridad

El .env File Parser se ejecuta completamente en su navegador sin procesamiento del lado del servidor. Sus variables de entorno, incluyendo claves de API, credenciales de base de datos y tokens secretos, nunca se transmiten por la red. La lógica de análisis, validación, conversión de formato y combinación son todas funciones de JavaScript que se ejecutan localmente. La herramienta funciona sin conexión después de la carga inicial de la página. Ningún script de análisis de terceros tiene acceso al contenido del área de texto.

Preguntas Frecuentes

¿Es gratuito el .env File Parser? Sí, completamente gratuito sin necesidad de cuenta.

¿Es seguro pegar claves de API y secretos reales? Sí. Todo el procesamiento ocurre en su navegador usando JavaScript local. Nada se envía a ningún servidor. Sus secretos permanecen en su máquina.

¿Puedo usarlo sin conexión? Sí. Después de que la página cargue, el análisis y la conversión funcionan sin conexión a internet.

¿Soporta valores multilínea? El parser maneja valores entre comillas de una sola línea. Los valores verdaderamente multilínea que abarcan múltiples líneas (usando una continuación con barra invertida o sintaxis estilo heredoc) no son compatibles actualmente. Divida el contenido multilínea en una sola línea entre comillas antes de analizarlo.

¿Por qué mi valor entre comillas todavía aparece en la salida sin comillas? La función unquoteValue elimina las comillas simples o dobles coincidentes que envuelven todo el valor. DATABASE_URL="postgres://..." se convierte en postgres://... internamente y se vuelve a poner entre comillas según sea necesario en el formato de salida. Este es el comportamiento correcto para la conversión de formatos.

¿Qué sucede con las líneas de comentarios en la salida? Los comentarios (líneas que comienzan con #) están excluidos de todos los formatos de salida. Solo se incluyen entradas de variables válidas. Los comentarios se cuentan en el panel de Estadísticas pero no se escriben en la salida.

¿Puedo combinar más de dos archivos? La herramienta admite combinar exactamente dos archivos a la vez. Para combinar tres o más archivos, combine A+B primero, copie el resultado en el modo Analizar, luego úselo como Archivo A para una segunda combinación con Archivo C.

¿La operación de ordenar preserva las líneas de comentarios? No. El botón Ordenar usa solo las variables válidas analizadas para reconstruir la entrada ordenada, descartando las líneas de comentarios y las líneas vacías. Use Ordenar cuando desee un archivo limpio y normalizado.

¿Qué es el formato Docker --env-file? docker run --env-file espera líneas KEY=VALUE sin comillas de shell. El formato de salida de Docker omite las comillas incluso para valores con espacios, lo cual es correcto para el formato Docker pero fallaría en un script de shell. Use el formato .env si necesita comillas seguras para shell.

¿Puedo detectar qué variables difieren entre dos archivos sin combinarlos? Cambie al modo Combinar y haga clic en Combinar Archivos. La lista de conflictos muestra cada clave donde el Archivo A y el Archivo B tienen valores diferentes, lo que sirve como una comparación práctica de variables diferentes.

Herramientas Relacionadas

• Config Generator — Genere archivos de configuración estructurados para varios frameworks y entornos.
• Docker Converter — Convierta entre formatos de configuración relacionados con Docker.
• YAML to TOML — Convierta entre formatos de archivo de configuración YAML y TOML.

Pruebe el .env File Parser ahora: .env File Parser & Formatter