03. Environments & Secretos por Proyecto - Guía Mise - Adiós nvm/pyenv

En este módulo aprenderás:

Manejo pro de variables [env], archivos .env automáticos y modificación del PATH.
Comandos y configuraciones clave para 03. Environments & Secretos por Proyecto
Ejercicios prácticos listos para probar en tu terminal local

Chau direnv: Variables de entorno nativas sin plugins extra

Mano, ¿cuántas veces has subido credenciales de desarrollo por olvidarte de exportar una variable en la terminal? Con mise, cuando te metes a la carpeta del proyecto (cd my-app), las variables se inyectan automáticamente en tu sesión de shell.

Carga nativa de .env • Cero dependencias adicionales

Árbol de ResoluciónJerarquía en Cascada

Orden de Precedencia de Entornos y Archivos de Configuración

1. Configuración Global~/.config/mise/config.toml

Base del Sistema

Herramientas por defecto para cualquier carpeta de tu máquina.

node = "24" python = "3.13"

2. Configuración de Workspace / Empresa~/work/.mise.toml

Cascada Jerárquica

Heredada automáticamente en todos los subdirectorios de trabajo.

AWS_PROFILE = "acme-corp" terraform = "1.9"

3. Configuración del Proyecto./mise.toml

Prioridad Local

Sobrescribe versiones y define variables de entorno del repo.

[env] NODE_ENV = "development" _.file = ".env"

4. Secretos y Credenciales Locales./.env (No commiteado)

Máxima Prioridad

API keys y contraseñas inyectadas en memoria al entrar al directorio.

DATABASE_URL="postgres://..." OPENAI_API_KEY="sk-..."

✓

Resultado Final: Contexto Activo de la ShellEvaluado al hacer `cd`

Todas las variables y binarios son consolidados de menor a mayor prioridad. Las variables locales sobrescriben limpiamente a las globales.

Ejemplo Real: Configuración de Base de Datos y API Key

Imagina que tienes este archivo .env en la raíz de tu backend:

.envbash

DATABASE_URL="postgresql://postgres:secret123@localhost:5432/curso_db"
JWT_SECRET="ultra-secret-key-latam-2026"
PORT=8080

En tu mise.toml le dices a mise que lo lea automáticamente con _.file = ".env":

mise.tomltoml

[env]
# Cargar automáticamente tu archivo .env local
_.file = ".env"

# Definir variables específicas de desarrollo
NODE_ENV = "development"
API_URL = "http://localhost:8080"

# Agregar carpetas custom al PATH del proyecto
_.path = ["./node_modules/.bin", "./bin"]

Comandos para inspeccionar tu entorno

mise set PORT=8080: Agrega o actualiza una variable directamente en tu mise.toml.
mise unset PORT: Remueve la variable del archivo.
mise env: Muestra todas las variables exportadas por mise en la sesión actual.
mise en: Abre una sub-shell con todo el entorno inyectado.

Jamás commitees tu .env con secretos reales

Asegúrate de agregar .env a tu .gitignore. En mise.toml usa _.file = ".env" para que cada dev del equipo tenga su .env local con sus propias llaves API sin chocar con el repositorio.

Reto Ninja de la Lección 🥷

Demuestra que dominas las variables de entorno en mise respondiendo este test rápido:

Reto Ninja: Environments & Secretos 🔐

Pregunta 1/3

❯reto --step=1

¿Qué directiva en [env] de mise.toml se utiliza para cargar automáticamente las variables de tu archivo .env local?

Ejercicio Práctico Ninja 🥷

En tu proyecto crea un archivo .env con DATABASE_URL="postgresql://localhost:5432/mydb".
Añade _.file = ".env" dentro de la sección [env] de tu mise.toml.
Haz echo $DATABASE_URL en tu terminal y verifica que imprima la cadena de conexión inmediatamente.

¿Terminaste esta lección?

Marca tu progreso para sincronizar el avance en tu navegador.

Anterior02. Dev Tools & Versiones Políglotas Siguiente04. Task Runner Ultra Rápido