martes 24 febrero 2026

Cómo usar variables de entorno en Python

python-dotenv es una librería que permite cargar variables de entorno desde un archivo .env en proyectos Python. Se utiliza para gestionar configuraciones sensibles como claves API, credenciales o entornos de desarrollo sin exponer datos en el código fuente.

¿Qué es y cómo funciona python-dotenv?

En muchos proyectos, las variables de entorno almacenan información sensible como contraseñas, tokens o configuraciones específicas del entorno (desarrollo, pruebas o producción).

La librería python-dotenv permite:

Leer un archivo .env
Cargar automáticamente sus variables en el entorno del sistema
Acceder a ellas mediante os.environ o os.getenv()

1️⃣ Instalación

pip install python-dotenv

2️⃣ Crear archivo `.env`

API_KEY=123456789
DEBUG=True
DATABASE_URL=postgresql://user:password@localhost/db

3️⃣ Cargar variables en tu aplicación

from dotenv import load_dotenv
import os

load_dotenv()

api_key = os.getenv("API_KEY")
debug = os.getenv("DEBUG")

print(api_key)
print(debug)

Algunos ejemplos prácticos

Configuración por entorno

import os
from dotenv import load_dotenv

load_dotenv()

if os.getenv("ENV") == "development":
    print("Modo desarrollo activado")

Uso con frameworks (Flask)

from flask import Flask
from dotenv import load_dotenv
import os

load_dotenv()

app = Flask(__name__)
app.config["SECRET_KEY"] = os.getenv("SECRET_KEY")

Buenas prácticas

Agregar .env al archivo .gitignore
No subir credenciales al repositorio
Usar diferentes .env para cada entorno

Etiquetas:

python

Creado por:

Jorge García

Fullstack developer