Instalar o Java: configure o JDK no Windows, macOS e Linux

O que você realmente precisa: o JDK

Na página anterior você viu que o Java é compilado para bytecode e roda na JVM. Para fazer as duas coisas na sua própria máquina você instala uma única coisa: o JDK (Java Development Kit). O JDK reúne o compilador javac, a JVM que executa o seu bytecode e a biblioteca padrão que você usa.

Você também pode ouvir falar do JRE (Java Runtime Environment). O JRE pode executar um programa Java, mas não pode compilá-lo, pois não tem javac. Como desenvolvedor, você quer o JDK, que é um superconjunto do JRE. Os downloads modernos entregam o JDK por padrão, então você raramente precisa escolher.

Você não precisa de nada disso só para acompanhar os exemplos daqui: os blocos do editor nestas páginas rodam na nuvem. Instale um JDK quando quiser compilar e executar Java no seu próprio computador.

Escolha uma versão e um fornecedor

Duas decisões rápidas antes de baixar.

Versão: instale a versão LTS (suporte de longo prazo) mais recente. Em 2026, essa é a Java 21. As versões LTS têm suporte por anos e são as que projetos reais usam como alvo, então você evita surpresas. As versões não LTS saem a cada seis meses e servem bem para experimentar, mas a LTS é a escolha segura por padrão.

Fornecedor: a linguagem "Java" tem muitas distribuições gratuitas, todas compiladas a partir do mesmo código-fonte do OpenJDK. Qualquer uma destas é uma escolha sólida e sem custo:

• Eclipse Temurin (da Adoptium): a build comunitária mais popular.
• Amazon Corretto: gratuita, com suporte de longo prazo, pela AWS.
• Azul Zulu: outra build gratuita bem mantida.

Escolha uma, pegue o instalador para o seu sistema operacional e siga em frente. Elas se comportam da mesma forma para tudo neste curso.

Evite o download de "Java" para usuários comuns do java.com: aquele é o antigo JRE para usuário final, não um JDK. Vá até a página de downloads para desenvolvedores do fornecedor que você escolheu.

Instale na sua plataforma

A mecânica varia um pouco conforme o sistema operacional. Use um gerenciador de pacotes se tiver um: ele torna as atualizações indolores.

Windows

• Baixe o instalador .msi (por exemplo, o Temurin 21) e execute-o. Durante a instalação, ative a opção de definir JAVA_HOME e adicionar ao PATH, se for oferecida.
• Ou com o gerenciador de pacotes winget:

winget install EclipseAdoptium.Temurin.21.JDK

macOS

• Baixe o instalador .pkg e execute-o, ou use o Homebrew:

brew install temurin

Linux (Debian/Ubuntu)

sudo apt update
sudo apt install openjdk-21-jdk

No Fedora/RHEL é sudo dnf install java-21-openjdk-devel. Esses são comandos de shell, não Java: eles instalam o JDK em todo o sistema.

Verifique se deu certo

Esta é a etapa que as pessoas pulam e depois perdem uma hora por causa disso. Abra um novo terminal (para que ele pegue o PATH atualizado) e rode dois comandos.

java -version

Você deve ver algo como:

openjdk version "21.0.3" 2024-04-16 LTS
OpenJDK Runtime Environment Temurin-21.0.3+9 (build 21.0.3+9-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.3+9 (build 21.0.3+9-LTS, mixed mode)

Agora confirme que o compilador está presente: esta é a parte que comprova que você tem o JDK e não apenas um ambiente de execução:

javac -version

javac 21.0.3

Se java -version funciona mas javac retorna command not found, você instalou um pacote só com o JRE ou o seu PATH aponta para um ambiente de execução. Instale o pacote do JDK (os nomes acima terminam todos em -jdk ou -devel) e reabra o terminal.

Um teste rápido local

Quando os dois comandos retornam uma versão, sua máquina já consegue compilar e executar Java. O mesmo programa que você vai compilar localmente também roda aqui mesmo no navegador, então dá para conferir a saída antes mesmo de tocar em um terminal:

public class Main {
    public static void main(String[] args) {
        String version = System.getProperty("java.version");
        System.out.println("Java is working. Running on version " + version);
    }
}

System.getProperty("java.version") pergunta à JVM em execução qual é a versão dela: uma forma prática de confirmar que sua instalação corresponde ao que você espera. Na sua própria máquina, você salvaria isto como Main.java, compilaria com javac e executaria com java. Essa dança de dois passos é exatamente o que a próxima página aborda.

Sobre JAVA_HOME e PATH

Duas variáveis de ambiente aparecem o tempo todo:

• PATH diz ao seu shell onde encontrar os executáveis java e javac. Se java -version roda a partir de qualquer diretório, seu PATH está configurado corretamente. A maioria dos instaladores cuida disso para você.
• JAVA_HOME aponta para a pasta de instalação do JDK. Você não precisa dela só para rodar java, mas ferramentas de build como Maven e Gradle, e muitas IDEs, a leem para localizar o seu JDK. Defina-a para a pasta que contém o diretório bin (não o bin em si).

Se mais tarde alguma ferramenta reclamar que não encontra um JDK mesmo com java -version funcionando, a causa quase sempre é um JAVA_HOME não definido ou incorreto.

Próximo: Executando Java

Você já tem um JDK funcional e verificou o compilador. A próxima página transforma isso em um fluxo de trabalho real: escrever um arquivo .java, compilá-lo com javac, executá-lo com java e entender o que cada etapa produz pelo caminho.