Variáveis ambiente: guia completo para configurar

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, como define a Wikipedia (2026-07-31). Na prática, elas guardam configurações que seu sistema e seus programas precisam, como caminhos de pastas, chaves de API e credenciais. Este guia mostra como configurá-las em Windows, macOS e Linux, e como usá-las sem comprometer a segurança do seu projeto.

Passo 1: Entenda o que são e onde ficam

Antes de configurar, é útil saber que existem variáveis de ambiente do sistema (globais) e as do usuário. As do sistema valem para todos os usuários do computador; as do usuário, apenas para você. Em geral, as do usuário são suficientes para a maioria dos projetos. Uma dica: evite alterar variáveis do sistema sem necessidade, pois isso pode afetar outros programas.

Passo 2: Configure no Windows

Na barra de busca do Windows, digite "variáveis" e escolha "Editar as variáveis de ambiente do sistema". Clique em "Variáveis de ambiente". Você verá duas listas: uma para o usuário e outra para o sistema. Para criar uma nova, selecione a lista do usuário, clique em "Nova" e informe o nome e o valor. Um erro comum é esquecer de abrir um novo terminal após a alteração: o prompt só lê as variáveis na inicialização.

Passo 3: Configure no macOS e Linux

No macOS e no Linux, as variáveis de ambiente são definidas no shell. O arquivo de configuração varia: ~/.zshrc no macOS (padrão desde o Catalina) e ~/.bashrc ou ~/.profile no Linux. Edite o arquivo com um editor de texto e adicione uma linha como export MINHA_VARIAVEL="valor". Depois, execute source ~/.zshrc (ou o caminho do seu arquivo) para carregar as mudanças. Um erro comum é usar espaços em torno do sinal de igual, o que quebra a sintaxe.

Passo 4: Use variáveis no seu projeto

Em código, você lê a variável com a função apropriada da linguagem. Por exemplo, em Python, use os.environ.get('MINHA_VARIAVEL'); em Node.js, process.env.MINHA_VARIAVEL. A vantagem é que você não precisa gravar segredos no código-fonte. Uma ressalva importante: nunca commite arquivos .env com credenciais reais. Use um arquivo .env.example com valores fictícios e mantenha o real fora do repositório.

Passo 5: Evite erros comuns

Além dos já citados, outro erro frequente é dar nomes genéricos demais, como "config" ou "valor". Prefira nomes descritivos, como DATABASE_URL ou API_KEY. Também evite colocar espaços ou caracteres especiais no nome. Se você está em um time, documente quais variáveis são necessárias para rodar o projeto, para que ninguém fique perdido.

Checklist do que você fez

• Entendeu o que são variáveis de ambiente e onde elas ficam.
• Configurou no Windows, macOS ou Linux de acordo com o seu sistema.
• Criou uma variável e a leu no seu código.
• Manteve credenciais fora do código e do repositório.
• Documentou as variáveis para o seu time ou para o futuro você.

FAQ

O que são variáveis de ambiente?

Variáveis de ambiente são valores nomeados dinamicamente que afetam o comportamento de processos em execução. Elas armazenam configurações como caminhos e credenciais, permitindo que programas usem esses dados sem embutir no código-fonte.

Como vejo as variáveis de ambiente no Windows?

Abra o Prompt de Comando e digite set. Isso lista todas as variáveis de ambiente do usuário e do sistema. Para ver uma específica, use echo %NOME_DA_VARIAVEL%.

Como vejo as variáveis de ambiente no Linux ou macOS?

No terminal, use o comando env para listar todas as variáveis. Para uma específica, use echo $NOME_DA_VARIAVEL.

Posso usar variáveis de ambiente para armazenar senhas?

Sim, é uma prática comum, mas você deve ter cuidado. Nunca coloque credenciais em código versionado. Use arquivos .env que não são commitados e defina permissões restritas de leitura.

O que é um arquivo .env?

É um arquivo de texto simples que define variáveis de ambiente no formato NOME=valor. Muitas linguagens e frameworks carregam esse arquivo automaticamente. O arquivo real não deve ser versionado; apenas um exemplo com valores fictícios.

Preciso reiniciar o computador após configurar variáveis?

No Windows, não, basta abrir um novo terminal. No macOS e Linux, execute source no arquivo de configuração ou abra uma nova janela do terminal.