Variables de entorno: $env/static y $env/dynamic
Acceda de forma segura a las variables de entorno en el servidor y el cliente de SvelteKit.
Variables de entorno: $env/static y $env/dynamic es una lección gratuita de Sveltejs Academy en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Sveltejs Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Sveltejs Academy incluye 4 lecciones en total.
API de entorno de SvelteKit
SvelteKit expone las variables de entorno mediante cuatro módulos: static/private, static/public, dynamic/private y dynamic/public.
Privado estático
Se lee durante la compilación y solo está disponible en el servidor. Se elimina del paquete del cliente.
import { DB_URL } from "$env/static/private";Público estático
Se lee durante la compilación, debe comenzar por PUBLIC_ y se incluye en el paquete del cliente.
import { PUBLIC_API_URL } from "$env/static/public";Privado dinámico
Se lee durante la ejecución en el servidor. Resulta útil para cambiar la configuración sin volver a compilar.
import { env } from "$env/dynamic/private";
console.log(env.SECRET);Público dinámico
Se lee durante la ejecución y está disponible tanto en el cliente como en el servidor. Debe comenzar por PUBLIC_.
Elegir el adecuado
Utilice static cuando los valores no cambien durante la ejecución y dynamic cuando sí cambien (por ejemplo, para indicadores de funcionalidades).
Los secretos nunca son públicos
Nunca anteponga PUBLIC_ a los secretos; se filtrarán al paquete del cliente.
Archivo de entorno
Guarde los valores en .env (ignorado por git) y .env.example (incluido en el repositorio).
Seguridad de tipos
Las variables static reciben tipos automáticamente. Las variables dynamic reciben tipos mediante Record
Vercel y Cloudflare
Cada plataforma tiene su propia interfaz para las variables de entorno. Sincronícelas deliberadamente entre los distintos entornos.
Pruebas
Simule los módulos de entorno en las pruebas si depende de ellos.
Comprobación rápida
¿Qué prefijo se requiere para las variables de entorno públicas?
Resumen
Utilice $env/static/private para los secretos y variables con el prefijo PUBLIC_ para los valores seguros para el cliente. Elija entre static y dynamic según sus necesidades.
Preguntas frecuentes
¿La lección «Variables de entorno: $env/static y $env/dynamic» es gratis?
Sí — el texto completo de «Variables de entorno: $env/static y $env/dynamic» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Sveltejs Academy, actualiza a CoddyKit PRO. El curso de Sveltejs Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Variables de entorno: $env/static y $env/dynamic»?
Acceda de forma segura a las variables de entorno en el servidor y el cliente de SvelteKit. Practicas Sveltejs Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Sveltejs Academy?
No se requiere experiencia previa. Sveltejs Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.
¿Cuánto tiempo toma la lección «Variables de entorno: $env/static y $env/dynamic»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Sveltejs Academy?
Sí. Cada lección de Sveltejs Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Protección CSRF en form actions
- Prevención de XSS en {#html}
- Variables de entorno: $env/static y $env/dynamic
- Limitación de solicitudes con hooks