Variáveis de ambiente: o que são e como usar corretamente

Variáveis de ambiente são valores nomeados dinamicamente que podem afetar o modo como os processos em execução irão se comportar em um computador (Wikipedia, 2026-07-10). Elas funcionam como pares de chave-valor que o sistema operacional disponibiliza para todos os programas em execução. Na prática, usamos variáveis de ambiente para armazenar configurações que variam entre ambientes (desenvolvimento, teste, produção) sem precisar alterar o código-fonte. Isso inclui caminhos de diretórios, strings de conexão com banco de dados, chaves de API e senhas.

Para que servem as variáveis de ambiente?

Elas evitam que informações sensíveis fiquem expostas no código. Em vez de escrever uma senha diretamente no script, você a armazena em uma variável de ambiente e acessa via código. Também servem para padronizar caminhos de instalação (como PATH no Windows) e definir configurações de sistema, como o fuso horário ou o idioma padrão.

Como configurar variáveis de ambiente no Windows?

No Windows, abra o menu Iniciar, digite "variáveis" e clique em "Editar as variáveis de ambiente do sistema". Na janela que abrir, clique em "Variáveis de Ambiente". Há duas listas: variáveis do usuário (afetam apenas seu perfil) e variáveis do sistema (afetam todos os usuários). Clique em "Nova" para adicionar uma nova variável, informando nome e valor. Para alterar o PATH, localize a variável na lista, clique em "Editar" e adicione o novo caminho.

Como configurar variáveis de ambiente no Linux e macOS?

No terminal, use o comando export NOME_VARIAVEL=valor para definir uma variável temporária (válida apenas na sessão atual). Para torná-la permanente, adicione essa linha ao arquivo ~/.bashrc (Linux) ou ~/.zshrc (macOS). Para remover, use unset NOME_VARIAVEL. Para listar todas as variáveis ativas, digite env ou printenv. Lembre-se de que, após editar o arquivo de configuração, execute source ~/.bashrc para recarregar.

Como acessar variáveis de ambiente no código?

Em Python, use os.environ['NOME_VARIAVEL'] ou os.getenv('NOME_VARIAVEL'). Em JavaScript (Node.js), use process.env.NOME_VARIAVEL. Em PHP, getenv('NOME_VARIAVEL'). Em Java, System.getenv("NOME_VARIAVEL"). A sintaxe varia, mas o conceito é o mesmo: buscar o valor definido no sistema operacional.

Quais são as boas práticas?

Nunca armazene variáveis de ambiente em arquivos versionados do repositório. Use um arquivo .env local (ignorado pelo Git) para desenvolvimento e defina as variáveis diretamente no servidor de produção. Prefira nomes em maiúsculas com underscores (ex.: DB_HOST). Evite expor variáveis de ambiente em logs ou mensagens de erro. Documente quais variáveis são necessárias para o projeto em um arquivo .env.example.

Diferença entre variáveis de ambiente e variáveis de shell

Variáveis de shell existem apenas dentro do terminal atual e não são herdadas por processos filhos. Já as variáveis de ambiente são exportadas automaticamente para todos os processos iniciados a partir daquele shell. Para transformar uma variável de shell em variável de ambiente, use o comando export (Linux/macOS) ou defina via interface gráfica no Windows.

FAQ

O que acontece se eu deletar uma variável de ambiente?

Se a variável for essencial para o sistema (como PATH), programas podem parar de funcionar corretamente. Variáveis de usuário removidas afetam apenas seu perfil. Sempre crie um backup antes de alterar variáveis do sistema.

Variáveis de ambiente funcionam em containers Docker?

Sim. No Docker, você define variáveis de ambiente no Dockerfile com ENV ou ao rodar o container com a flag -e. Elas ficam disponíveis para os processos dentro do container.

Posso usar variáveis de ambiente em arquivos de configuração?

Sim, muitos frameworks e ferramentas (como o .env do Laravel ou o dotenv do Node.js) permitem carregar variáveis de ambiente a partir de um arquivo local durante o desenvolvimento, simulando o ambiente de produção.

Como listar todas as variáveis de ambiente no Windows?

No Prompt de Comando, digite set. No PowerShell, use Get-ChildItem Env:. Ambos exibem a lista completa de variáveis e seus valores atuais.

Variáveis de ambiente são seguras?

Oferecem mais segurança do que hardcoding, mas não são criptografadas. Em ambientes compartilhados, qualquer processo com acesso ao sistema pode ler as variáveis. Para dados realmente sensíveis, combine com serviços de gerenciamento de segredos (como AWS Secrets Manager ou HashiCorp Vault).

Preciso reiniciar o computador após alterar variáveis de ambiente?

No Windows, aplicativos abertos antes da alteração não veem a mudança, você precisa reiniciar o programa. No Linux/macOS, após executar source ~/.bashrc, a alteração vale imediatamente para novas sessões do terminal.

Resumindo: variáveis de ambiente são uma camada essencial de configuração externa ao código. Elas separam o que varia entre ambientes do que é fixo na aplicação, reduzem riscos de vazamento de credenciais e facilitam a portabilidade. Aplicar as boas práticas desde o início do projeto evita retrabalho e dores de cabeça com segurança.