Revisar la configuración

Generador .env.example

Prepara una plantilla a partir de tu configuración y revisa los datos que conservas.

Generador .env.example

Origen .env

Vista previa .env.example

Se procesa en el navegador. Las entradas quedan en memoria, sin URL, telemetría ni historial local.

Opciones de la plantilla

Asignaciones: 5 · Sustituidas: 5 · Conservadas: 0 · Duplicados: 0 · Comentarios originales: 2

Los comentarios, las descripciones y los valores conservados pueden contener secretos. La herramienta no certifica que el archivo se pueda publicar.

Compartir la configuración de desarrollo no debería obligarte a repasar cada contraseña con el cursor. El Generador .env.example empieza con valores en blanco para todas las asignaciones. Después eliges por su nombre las excepciones que realmente necesita otra persona.

Esta plantilla de variables de entorno describe lo que falta por configurar. No prueba que la aplicación pueda arrancar: un campo vacío puede ser obligatorio, y el texto de un marcador no equivale a unas credenciales. Mantén esa distinción al preparar las instrucciones del proyecto.

Qué aporta el Generador .env.example

Conservar los nombres sin arrastrar valores

El Generador .env.example procesa cada valor entre comillas como una unidad, aunque ocupe varias líneas. Así no queda el final de una clave multilínea por haber borrado únicamente su primera línea. Si la sintaxis está rota, la conversión se detiene.

Dos paneles mantienen los marcadores de nombres y comentarios; las casillas con valores pasan a estar vacías.

Dejar instrucciones junto a la excepción

Puedes conservar un PORT de desarrollo tras revisarlo y añadir una explicación encima. Los demás valores siguen vaciándose. El contador de valores conservados permite comprobar el alcance de esa elección sin suponer que todos los números son inocuos.

Una fila seleccionada mantiene su valor y aparecen barras de descripción sobre las asignaciones.

Tres decisiones que cambian el resultado

01

Escribir las excepciones sin patrones

La lista admite nombres completos separados por comas o espacios y distingue mayúsculas. PORT no selecciona port. Un nombre ausente se indica en pantalla, pero no se añade una variable nueva por ese motivo.

02

Separar instrucciones de valores

Introduce KEY=descripción en una línea por nombre. El texto se convierte en comentario delante de cada aparición. No necesitas conservar comentarios antiguos para incluir estas explicaciones nuevas.

03

Renovar la revisión al editar

La generación automática espera 350 ms; en modo manual puedes usar Ctrl/Cmd + Enter. Cada cambio invalida la revisión anterior. No podrás copiar ni descargar hasta tener un resultado actualizado y volver a confirmar su revisión.

Mantener una plantilla útil para el equipo

No perder declaraciones repetidas

Se mantienen el orden, los prefijos export y todas las apariciones de un nombre. Las asignaciones ya vacías también permanecen. A diferencia de un mapa que solo guarda el último valor, la plantilla permite ver que una variable estaba declarada varias veces.

Elegir un marcador legible

El modo de marcador acepta una cadena personalizada de una sola línea, como YOUR_VALUE_HERE. Escapa las comillas y barras inversas al escribirla. Rechaza cadenas vacías y caracteres de control, para que el texto no introduzca otras asignaciones.

Controlar los comentarios originales

Una opción conserva o elimina tanto los comentarios completos como los situados detrás de un valor. Las líneas en blanco permanecen. Las descripciones nuevas llevan # al principio y se incluyen independientemente de esa opción.

Alcance del procesamiento

No hay detección automática de secretos
Todo valor ajeno a las excepciones se sustituye, incluso un número o booleano. Los comentarios, descripciones y valores conservados requieren revisión humana. El resultado no recibe ninguna garantía de que sea adecuado para un repositorio público.
La sintaxis admitida tiene límites
Los nombres usan letras ASCII, cifras y guion bajo, sin cifra inicial. Se aceptan cadenas entre comillas simples o dobles, incluidas las multilínea. Los errores de asignación, comillas sin cerrar y NUL bloquean la salida. Entrada y resultado admiten hasta 1 MiB cada uno; la entrada, hasta 10 000 asignaciones.
No se ejecuta ni se descubre configuración
El Generador .env.example no expande ${HOST}, ejecuta comandos, genera contraseñas ni busca variables en el código. Tampoco fusiona archivos, ordena nombres o elimina duplicados. La salida utiliza saltos de línea LF.
Las descripciones no añaden claves
Cada nombre solo puede aparecer una vez en la lista de descripciones. La explicación debe ocupar una línea física sin caracteres de control. Los nombres inexistentes se notifican y no se convierten en nuevas asignaciones; la herramienta no deduce su significado.

Preguntas sobre el Generador .env.example

¿Por qué se excluye .env de Git?

Un .env de trabajo puede contener contraseñas y otros datos de acceso. Para documentar los nombres se prepara una plantilla aparte, revisada y sin esos datos. Cambiar la extensión o generar el ejemplo no elimina secretos escritos en comentarios o conservados como excepciones.

¿Qué reglas de formato acepta?

Se admite el subconjunto dotenv descrito: nombres válidos, asignaciones KEY=value, prefijo export opcional y valores entre comillas. Las líneas incorrectas producen un error con posición. El objetivo es evitar que un fragmento no reconocido pase sin revisar a la plantilla.

¿Sirve el archivo para varios frameworks?

Puedes incluir asignaciones de distintos frameworks si respetan la sintaxis admitida. La herramienta no carga plantillas de Laravel, Django o Next.js ni valida sus campos obligatorios. Solo transforma los nombres y valores que ya has proporcionado.

¿Se conservan los comentarios?

Sí, al activar la opción correspondiente. Se conservan comentarios de línea completa y comentarios finales. Puedes retirarlos sin perder las líneas vacías, y añadir descripciones nuevas aunque hayas desactivado los comentarios originales.

¿Se puede cambiar el marcador de posición?

Sí. Selecciona el modo de marcador y escribe un texto no vacío en una sola línea. Las comillas y barras inversas se escapan. El marcador se aplica también a valores antes vacíos, salvo que su nombre figure en la lista de excepciones.

¿Dudas sobre un valor o una regla?

Comparte los nombres que hay que configurar

Vuelve al Generador .env.example para ajustar excepciones, revisar los comentarios y preparar un archivo que tus compañeros puedan completar.