Contáctanos
Webflow Premium Partner Ehab Fayez
Volver a Agent Skills
Seguridad y Calidad

dotenv Environment Management

Carga variables de entorno desde archivos .env en process.env para desarrollo local y configuración.

Claude Code Cursor Copilot Windsurf Gemini CLI Codex

Descripción General

dotenv es un módulo sin dependencias que carga variables de entorno desde un archivo .env en process.env. Sigue la metodología de aplicación de doce factores separando la configuración del código, facilitando el cambio de configuraciones entre entornos sin modificar el código de la aplicación.

La biblioteca soporta expansión de variables (referencia a otras variables), valores multilínea y comentarios. El paquete complementario dotenv-expand habilita interpolación de variables dentro de archivos .env. Para proyectos TypeScript, dotenv proporciona definiciones de tipos y funciona perfectamente con bibliotecas de validación como Zod o t3-env para asegurar que todas las variables de entorno requeridas estén presentes y correctamente tipadas.

Las mejores prácticas de seguridad con dotenv incluyen nunca commitear archivos .env al control de versiones (agregar a .gitignore), proporcionar un archivo .env.example con valores placeholder para documentación, y usar diferentes archivos .env para diferentes entornos (.env.local, .env.production). La extensión dotenv-vault agrega gestión cifrada de archivos .env para colaboración en equipo y despliegues CI/CD.

¿Para Quién Es?

  • Cargar URLs de base de datos y claves API desde archivos .env
  • Configurar configuración específica por entorno para dev/staging/prod
  • Validar variables de entorno con esquemas Zod
  • Compartir configuraciones de entorno de forma segura en el equipo

Instalación

Configurar Claude Code
npm install dotenv

Configuración

// .env
DATABASE_URL="postgresql://user:pass@localhost:5432/mydb"
API_KEY="sk-1234567890"

// app.ts
import "dotenv/config"
// or
import dotenv from "dotenv"
dotenv.config()

console.log(process.env.DATABASE_URL)