Cómo usar: Validador de archivos .env
- Pega tu
.enven el cuadro de la izquierda. Opcionalmente, pega.env.example(o una lista de claves requeridas) a la derecha. - Revisa la lista de problemas: los errores rompen el análisis, las advertencias son probablemente equivocaciones o valores riesgosos.
- Revisa la tabla de cada variable: los valores están enmascarados para que puedas compartir una captura de pantalla sin riesgo.
- Descarga el
.env.examplegenerado y súbelo a Git en lugar de tu.envreal.
Sintaxis de .env en pocas palabras
| Línea | Resultado |
|---|---|
PORT=3000 | Valor simple |
APP_NAME="Mi App" | Se necesitan comillas para los espacios |
GREETING='Hola $USER' | Comillas simples: no se expande la variable (dotenv-expand, Docker Compose) |
KEY="línea1\nlínea2" | Comillas dobles: \n se convierte en un salto de línea |
export TOKEN=abc | El prefijo export está permitido y dotenv lo ignora |
# comentario | Comentario; después de un valor solo cuando va precedido de un espacio y el valor no tiene comillas |
Errores comunes que detecta este validador
- Claves duplicadas: la mayoría de los cargadores conservan en silencio el primer o el último valor, así que los cambios parecen no tener efecto.
- Espacios alrededor de = o en valores sin comillas:
KEY = valorfalla en shells y en Docker. - Comillas sin cerrar que se tragan las líneas siguientes.
- Nombres inválidos: las claves deben tener letras, dígitos y guiones bajos, y no empezar por un dígito.
- Secretos como claves de AWS, claves live de Stripe, tokens de GitHub o claves privadas: no hay problema en un .env local, pero nunca los subas a Git.
Mantén .env fuera de Git
Añade .env a tu .gitignore y sube un .env.example con solo las claves. En CI, guarda los valores como secretos; consulta el Generador de flujos de trabajo de GitHub Actions. Los frameworks de front-end exponen variables con prefijos como VITE_, NEXT_PUBLIC_ o PUBLIC_ al navegador: nunca pongas secretos en ellas.
También se busca como: validador de archivo env, comprobador de .env, validador dotenv, generador de env example, revisar variables de entorno, variables de entorno faltantes, sintaxis dotenv, formato de archivo env.
Herramientas que combinan con: Validador de archivos .env
- Generador de Docker Compose — Marca los servicios que necesites —aplicación, base de datos, caché, interfaz de administración, receptor de correo— y obtén un archivo `compose.yaml` limpio con imágenes fijadas, volúmenes con nombre, comprobaciones de estado y depends_on condiciones, además de un archivo .env a juego con contraseñas generadas.
- Generador de package.json — Rellena el formulario y obtén un package.json válido: validación del nombre en npm, plantillas de scripts para Vite, Next.js, Node y librerías TypeScript, exports, engines, licencia y repositorio, con avisos de los errores más comunes.
- Inspector de caracteres Unicode — Pega lo que quieras para ver de qué está compuesto realmente: el nombre de cada carácter, su punto de código, los bytes UTF-8 y el código HTML.
- Comprobador de diferencias — Pega la versión original y la modificada para ver, una al lado de la otra, las líneas añadidas, eliminadas y modificadas, con las palabras exactas que han cambiado resaltadas dentro de cada línea.
Preguntas frecuentes
¿Es seguro pegar mi .env aquí?
El validador se ejecuta solo en tu navegador; nada se sube ni se guarda. Los valores aparecen enmascarados en el informe. Aun así, evita pegar secretos de producción en cualquier sitio web si tu política lo prohíbe: usa mejor el archivo de ejemplo.
¿Necesito comillas en un archivo .env?
Solo cuando el valor contiene espacios, #, comillas o saltos de línea, o empieza por un carácter especial. Las comillas dobles permiten escapes como \n; las comillas simples mantienen el valor literal.
¿Para qué sirve .env.example?
Documenta qué variables necesita el proyecto, sin valores reales. Súbelo a Git para que los nuevos compañeros y el CI sepan qué configurar, y mantén el .env real fuera de Git.
¿Por qué mi variable sigue indefinida?
Causas habituales: un error tipográfico o distinta capitalización en la clave, un duplicado más abajo en el archivo, espacios alrededor de =, una comilla sin cerrar en una línea anterior, o el archivo no se carga (carpeta incorrecta o falta la configuración de dotenv). Los bundlers de front-end también requieren prefijos como VITE_ o NEXT_PUBLIC_.
¿Puedo instalar Validador de archivos .env como aplicación web y utilizarla sin conexión?
Sí. Validador de archivos .env es una aplicación web instalable (PWA): se instala desde el navegador, no se descarga desde una tienda de aplicaciones. Haz clic en «Instalar aplicación» en la parte superior de esta página en Chrome o Edge (Windows, macOS, Linux, ChromeOS) o, en Android, utiliza «Compartir» → «Añadir a la pantalla de inicio» en iPhone y iPad, o «Archivo» → «Añadir al Dock» en Safari 17+ en un Mac. A continuación, se abrirá en su propia ventana con su propio icono y, como se ejecuta íntegramente en tu navegador, seguirá funcionando sin conexión. Firefox en el ordenador de sobremesa no permite instalar aplicaciones web. Cómo funciona la instalación.