# Variáveis ambiente: guia completo para configurar

> Variáveis de ambiente são valores nomeados que controlam o comportamento de processos em sistemas operacionais. O guia completo aborda configuração em Windows, Linux e macOS, incluindo sintaxe de exportação e persistência. A segurança exige evitar expor segredos em repositórios, usando arquivos .env e ferramentas de gerenciamento. A configuração correta permite personalizar execuções sem alterar código-fonte.

*Digitorack · Apps e Software · 31 de julho de 2026 · Letícia Sampaio Khoury*

Variáveis de ambiente são valores nomeados que controlam o comportamento de processos no computador. Este guia mostra como configurá-las em diferentes sistemas e como usá-las com segurança em seus projetos.

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.

---

Fonte (canonical): https://digitorack.com.br/apps-e-software/variaveis-ambiente-guia-completo-para-configurar/