Saltar al contenido
uencoder

dotenv

dotenv es la librería y convención que carga archivos .env en variables de entorno; es la más popular del ecosistema Node.js y externaliza la configuración.

Propósito

Permitir que el desarrollo local gestione la configuración con un archivo .env mientras producción usa variables de entorno reales, sin cambios de código.

Mecanismo

Al arrancar lee el archivo .env, analiza las líneas KEY=VALUE y las inyecta en process.env. Admite varios entornos (.env.development), interpolación de variables ($VAR) y manejo de comillas. No sobrescribe variables existentes (salvo con override).

Casos de uso

  • Configuración local de proyectos Node.js
  • Variables de entorno de Next.js/Vite
  • env_file de Docker Compose
  • Aislamiento de entornos de prueba

Ejemplos

  • entrada 
    .env: API_KEY=secret
    Output 
    process.env.API_KEY="secret"

    Loaded into the environment

Errores comunes

Loading dotenv in production wastes startup time
Use real environment variables in production and do not load .env

Términos relacionados

ENV
Un archivo ENV define variables de entorno en formato KEY=VALUE para la configuración de aplicaciones; es el enfoque recomendado de las apps 12-factor.
GLOSARIO
INI
INI es un formato tradicional de archivo de configuración que agrupa ajustes con cabeceras [section] y pares key=value; es simple pero no está estandarizado, y las implementaciones difieren ligeramente.
GLOSARIO
Properties
Los archivos Properties de Java usan el formato CLAVE=VALOR o CLAVE:VALOR; son el formato de configuración tradicional del ecosistema Java y admiten escapes Unicode.
GLOSARIO

Herramientas relacionadas

Analizador de ENV
Analiza líneas KEY=VALUE estilo .env a JSON. Se omiten las líneas vacías y los comentarios con #. Las convenciones de dotenv más allá de eso no están implementadas: un prefijo "export " se mantiene en la clave (export PORT=3000 → "export PORT") y las comillas alrededor de los valores se conservan tal cual.
HERRAMIENTA
Serializador de ENV
ENV Stringify — herramienta 100% del lado del cliente. Privacidad primero, sin round-trip al servidor.
HERRAMIENTA
De JSON a ENV
Json To Env — herramienta 100% del lado del cliente. Privacidad primero, sin round-trip al servidor.
HERRAMIENTA
De YAML a ENV
Yaml To Env — herramienta 100% del lado del cliente. Privacidad primero, sin round-trip al servidor.
HERRAMIENTA

References