Variáveis de ambiente: $env/static e $env/dynamic
Acesse variáveis de ambiente com segurança no servidor e no cliente do SvelteKit.
Variáveis de ambiente: $env/static e $env/dynamic é uma aula grátis de Sveltejs Academy no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Sveltejs Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Sveltejs Academy inclui 4 aulas no total.
API de variáveis de ambiente do SvelteKit
O SvelteKit expõe variáveis de ambiente por meio de quatro módulos: estáticas/privadas, estáticas/públicas, dinâmicas/privadas e dinâmicas/públicas.
Estáticas privadas
Lidas no momento da compilação e disponíveis apenas no servidor. Removidas do pacote do cliente.
import { DB_URL } from "$env/static/private";Estáticas públicas
Lidas no momento da compilação, devem começar com PUBLIC_ e são incluídas no pacote do cliente.
import { PUBLIC_API_URL } from "$env/static/public";Dinâmicas privadas
Lidas em tempo de execução no servidor. Úteis para alterar a configuração sem novas compilações.
import { env } from "$env/dynamic/private";
console.log(env.SECRET);Dinâmicas públicas
Lidas em tempo de execução e disponíveis tanto no cliente quanto no servidor. Devem começar com PUBLIC_.
Escolha a opção certa
Use a opção estática quando os valores não mudarem em tempo de execução; use a dinâmica quando mudarem (por exemplo, para sinalizadores de funcionalidades).
Segredos nunca são públicos
Nunca use o prefixo PUBLIC_ em segredos; eles serão expostos ao pacote do cliente.
Arquivo de ambiente
Armazene os valores em .env (ignorado pelo Git) e em .env.example (incluído no controle de versão).
Segurança de tipos
As variáveis estáticas são tipadas automaticamente. As variáveis dinâmicas são tipadas por meio de Record
Vercel e Cloudflare
Cada plataforma tem sua própria interface para variáveis de ambiente. Sincronize os ambientes de forma deliberada.
Testes
Simule os módulos de ambiente nos testes se depender deles.
Verificação rápida
Qual prefixo é obrigatório para variáveis de ambiente públicas?
Recapitulação
Use $env/static/private para segredos e variáveis com o prefixo PUBLIC_ para valores seguros no cliente. Escolha entre estáticas e dinâmicas conforme a necessidade.
Perguntas Frequentes
A aula “Variáveis de ambiente: $env/static e $env/dynamic” é grátis?
Sim — o texto completo de “Variáveis de ambiente: $env/static e $env/dynamic” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Sveltejs Academy, atualize para CoddyKit PRO. O curso de Sveltejs Academy inclui 4 aulas no total.
O que vou aprender em “Variáveis de ambiente: $env/static e $env/dynamic”?
Acesse variáveis de ambiente com segurança no servidor e no cliente do SvelteKit. Você pratica Sveltejs Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Sveltejs Academy?
Nenhuma experiência prévia é necessária. Sveltejs Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “Variáveis de ambiente: $env/static e $env/dynamic”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Sveltejs Academy?
Sim. Cada aula de Sveltejs Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Proteção contra CSRF em ações de formulários
- Prevenção de XSS em {#html}
- Variáveis de ambiente: $env/static e $env/dynamic
- Limitação de taxa com hooks