Configuração de Ambiente e Gerenciamento de Versões

Variáveis de ambiente e JAVA_HOME

Função de JAVA_HOME e variáveis relacionadas no ecossistema Java.

Intermediário 35 min 18 pontos Leitura 0%

Nesta aula você vai

  • Explicar o papel de JAVA_HOME
  • Configurar JAVA_HOME em Windows, Linux e macOS
  • Entender variáveis usadas por ferramentas (Maven, Gradle, IDEs)

Variáveis de ambiente e JAVA_HOME

Objetivos

Nesta aula você vai:

  • Entender por que JAVA_HOME existe
  • Configurá-la nos três sistemas operacionais
  • Saber quais ferramentas dependem dela

O que é JAVA_HOME?

JAVA_HOME aponta para o diretório raiz do JDK instalado (a pasta que contém bin, lib, etc.).

Ferramentas como Maven, Gradle, Tomcat e muitas IDEs usam JAVA_HOME para localizar o compilador e a JVM — não dependem só do java no PATH.

Como definir

Windows

  1. Configurações → Sistema → Sobre → Configurações avançadas → Variáveis de ambiente
  2. Nova variável de sistema: JAVA_HOME = C:\Program Files\Eclipse Adoptium\jdk-21...
  3. Reinicie o terminal

Linux / macOS

No ~/.bashrc, ~/.zshrc ou equivalente:

export JAVA_HOME=/opt/java-21
export PATH="$JAVA_HOME/bin:$PATH"

No macOS também:

export JAVA_HOME=$(/usr/libexec/java_home -v 21)

Verificação

echo $JAVA_HOME    # Linux/macOS
echo %JAVA_HOME%   # Windows CMD
ls $JAVA_HOME/bin/javac

Outras variáveis

Variável Uso
JAVA_HOME Raiz do JDK
PATH Deve incluir %JAVA_HOME%\bin ou $JAVA_HOME/bin
CLASSPATH Raramente necessário manualmente hoje
_JAVA_OPTIONS Flags JVM globais (cuidado em equipe)

Resumo

  • JAVA_HOME = caminho do JDK, não do arquivo java.exe dentro de bin
  • Configure PATH para incluir $JAVA_HOME/bin
  • Reinicie terminal/IDE após alterar variáveis