Variáveis de Ambiente: Configuração e Uso Prático

2026-05-12 Tempo de leitura: Cerca de 15 min Dificuldade: Iniciante

O Que Você Vai Aprender

• Verificar valores de variáveis de ambiente com echo $VAR ou env
• Definir suas próprias variáveis de ambiente com export
• Entender o PATH e corrigir erros "command not found" por conta própria
• Persistir configurações entre sessões usando .bashrc

Público-Alvo: Você conhece comandos básicos (pwd, cd, ls) mas não tem certeza do que $HOME ou export realmente significam.

Introdução: O Que São Variáveis de Ambiente?

1. Lendo Variáveis de Ambiente

Conclusão: Leia uma com echo $VAR e todas com env primeiro.

1-1. Mostrar uma variável: echo $VAR

$ echo $HOME

/home/lina

$ echo $USER

lina

1-2. Mostrar todas as variáveis: env / printenv

$ env

SHELL=/bin/bash
USER=lina
HOME=/home/lina
PATH=/usr/local/bin:/usr/bin:/bin
LANG=en_US.UTF-8
PWD=/home/lina
...

O env lista todas as variáveis de ambiente que você tem agora. O printenv faz o mesmo trabalho.

1-3. Variáveis comuns para conhecer

2. Definindo Variáveis: Atribuição vs export

Conclusão: Uma atribuição simples fica no shell atual. O export a transforma em variável de ambiente, herdada pelos filhos.

2-1. Atribuição simples (variável de shell)

$ MY_NAME=lina
$ echo $MY_NAME

lina

2-2. Promover para "variável de ambiente" com export

$ MY_NAME=lina
$ export MY_NAME

Ou de uma vez:

$ export MY_NAME=lina

2-3. Veja a diferença você mesmo

$ MY_VAR=hello
$ bash -c 'echo $MY_VAR'

Nada é impresso; você recebe uma linha em branco. O bash -c inicia um novo shell como processo filho, e o MY_VAR nunca chegou lá.

$ export MY_VAR=hello
$ bash -c 'echo $MY_VAR'

hello

Desta vez foi impresso. O export entregou o valor ao filho.

2-4. Deletar uma variável

$ unset MY_VAR
$ echo $MY_VAR

3. PATH: A Variável Mais Importante

Conclusão: O PATH é a lista de diretórios pesquisados por comandos. Sempre mantenha o :$PATH no final ao adicionar um.

3-1. Inspecionar PATH

$ echo $PATH

/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

3-2. Encontrar onde um comando mora: which

$ which ls

/usr/bin/ls

$ which python3

/usr/bin/python3

3-3. Adicionar um diretório pessoal ao PATH

Suponha que você queira uma pasta ~/bin para os seus próprios scripts.

$ mkdir -p ~/bin
$ export PATH="$HOME/bin:$PATH"

3-4. A ordem muda o comportamento

# Preferir minha versao
$ export PATH="$HOME/bin:$PATH"

# Preferir a versao do sistema (minha como fallback)
$ export PATH="$PATH:$HOME/bin"

3-5. Lina se atrapalha: sobrescrever o PATH

$ export PATH="/usr/local/bin:/usr/bin:/bin:$PATH"

4. Persistência: Sobrevivendo ao Próximo Login

Conclusão: O export vale apenas para o shell atual. Para manter um valor, escreva no ~/.bashrc e aplique com source.

$ cp ~/.bashrc ~/.bashrc.bak

$ cp ~/.bashrc.bak ~/.bashrc
$ source ~/.bashrc

4-1. Qual arquivo devo editar?

4-2. Exemplo de adições ao .bashrc

Adicione no final:

# Personal scripts directory
export PATH="$HOME/bin:$PATH"

# Locale
export LANG=en_US.UTF-8

# Default editor
export EDITOR=vim

4-3. Recarregar imediatamente com source

$ source ~/.bashrc

Ou o atalho com ponto:

$ . ~/.bashrc

5. Armadilhas Comuns

Conclusão: Um $ esquecido, espaços ao redor do =, um PATH sobrescrito e as aspasEnvolver um texto entre aspas (' ou ") para que seja tratado como um único valor, por exemplo um que tenha espaços. erradas. Esses quatro são os acidentes clássicos.

5-1. Esquecer / adicionar $

# Errado: imprime a string literal "HOME"
$ echo HOME

# Certo: expande o valor
$ echo $HOME

5-2. Espaços ao redor de =

# Errado: interpretado como um comando, falha
$ MY_VAR = hello

# Certo
$ MY_VAR=hello

5-3. Apagar o PATH

# Desastre: PATH existente e perdido
$ export PATH="$HOME/bin"

# Correto
$ export PATH="$HOME/bin:$PATH"

5-4. Aspas simples vs aspas duplas

$ NAME=lina

# Aspas duplas: $NAME e expandido
$ echo "Hello $NAME"

Hello lina

# Aspas simples: literal, sem expansao
$ echo 'Hello $NAME'

Hello $NAME

5-5. "Eu exportei mas meu script não vê"

Quando você executa um script como ./script.sh, as variáveis exportadas no shell pai são herdadas.

Um terminal novo é diferente. Ele lê o .bashrc do zero, então uma variável que não está escrita lá simplesmente não existe.

6. Prática Hands-On

Conclusão: Mostrar uma variável, adicionar ~/bin ao PATH e executar o próprio comando. Três exercícios levam da definição até a persistência.

Exercício 1: Coloque o seu nome em uma variável e mostre-o no formato "Hello, nome".

$ MY_NAME=lina
$ echo "Hello, $MY_NAME!"

Hello, lina!

Exercício 2: Crie um diretório ~/bin e faça com que ele também entre no PATH do próximo terminal.

$ mkdir -p ~/bin
$ echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
$ source ~/.bashrc
$ echo $PATH

/home/lina/bin:/usr/local/bin:/usr/bin:/bin

Exercício 3: Coloque um comando seu em ~/bin e chame-o de qualquer lugar.

$ cat > ~/bin/hello
#!/bin/bash
echo "Hello from my own script!"

$ chmod +x ~/bin/hello
$ hello

Hello from my own script!

7. Revisão

8. Resumo

# Inspecionar
echo $HOME                # Variavel unica
env                       # Todas as variaveis
env | grep PATH           # Filtrar
which nomecomando         # Onde ele esta?

# Definir
MY_VAR=value              # Variavel de shell (apenas shell atual)
export MY_VAR=value       # Variavel de ambiente (filhos tambem)
unset MY_VAR              # Deletar

# Adicionar ao PATH com seguranca
export PATH="$HOME/bin:$PATH"   # Sempre acrescente $PATH

# Persistir
vim ~/.bashrc             # Acrescente linhas de export
source ~/.bashrc          # Aplique agora

Resumo do Dia em 3 Linhas

1. O $VAR puxa o valor de uma variável. Leia o estado atual com echo $HOME ou env
2. Somente as variáveis marcadas com export são entregues aos processos filhos
3. Ao adicionar algo ao PATH, mantenha sempre o :$PATH no final