Configurando um Ambiente de Desenvolvimento Java

Um JDK por si só é suficiente para compilar e executar Java a partir de um terminal, mas para qualquer projeto maior do que alguns poucos arquivos, você vai querer um ambiente de desenvolvimento integrado (IDE). Uma IDE oferece autocompletar, refatoração, um depurador integrado e um modelo de projeto que entende a estrutura de pacotes do Java.

Este capítulo compara as principais IDEs, apresenta uma configuração recomendada e mostra como um projeto Java típico é organizado em disco.

Escolhendo uma IDE

As três IDEs Java mais populares são todas gratuitas para uso individual:

• IntelliJ IDEA Community Edition — a IDE Java da JetBrains. A edição gratuita Community é mais do que suficiente para a maioria dos aprendizados e muitos projetos em produção; a edição paga Ultimate adiciona suporte a frameworks como Spring e Jakarta EE. Recomendada para este livro.
• Eclipse IDE — a IDE open-source de longa data, popular em grandes empresas.
• VS Code com o Extension Pack for Java — mais leve que IntelliJ ou Eclipse, uma boa opção se você já usa VS Code para outras linguagens.

Você também pode acompanhar em um editor de texto simples (Vim, Sublime, Notepad) e usar os comandos javac e java diretamente — os primeiros capítulos deste livro mostram ambos os estilos.

IntelliJ IDEA: uma configuração recomendada

Se você não tem preferência, instale o IntelliJ IDEA Community Edition.

1. Baixe em jetbrains.com/idea e execute o instalador.
2. Inicie o IntelliJ e abra o diálogo New Project.
3. Selecione Java, depois escolha o JDK instalado no capítulo anterior no menu suspenso JDK (o IntelliJ geralmente detecta automaticamente; caso contrário, clique em Download JDK ou Add JDK).
4. Escolha Maven ou Gradle como sistema de build se quiser um, ou IntelliJ para um projeto de aprendizado simples.
5. Clique em Create.

O IntelliJ abrirá o novo projeto, indexará e posicionará o cursor dentro de um Main.java vazio. Pressione Shift+F10 (Windows/Linux) ou Control+R (macOS) para executá-lo.

VS Code

1. Instale o VS Code.
2. Abra a barra lateral Extensions e pesquise por Extension Pack for Java (publicado pela Microsoft).
3. Instale-o. O pacote inclui o servidor de linguagem Java, depurador, suporte ao Maven e algumas extensões relacionadas.
4. Abra uma pasta contendo um arquivo .java. O VS Code detectará o JDK e oferecerá opções para executar ou depurar o programa pelos ícones na margem lateral.

Se o VS Code não conseguir encontrar seu JDK, defina a configuração java.jdt.ls.java.home como o diretório raiz de instalação do JDK (o diretório que contém bin/javac).

Eclipse

1. Baixe o pacote Eclipse IDE for Java Developers em eclipse.org.
2. Descompacte e inicie.
3. Use File → New → Java Project, dê um nome e aceite o JDK padrão. O Eclipse cria uma pasta src/ onde seus arquivos .java ficam.

Estrutura do projeto

A maioria dos projetos Java segue uma convenção popularizada pelo Maven e adotada pelo Gradle:

my-project/
├── pom.xml               # Maven build file (or build.gradle for Gradle)
├── src/
│   ├── main/
│   │   ├── java/         # production source files
│   │   │   └── com/example/MyApp.java
│   │   └── resources/    # config files, templates, properties
│   └── test/
│       ├── java/         # test source files
│       │   └── com/example/MyAppTest.java
│       └── resources/    # test fixtures
└── target/               # compiled output (gitignored)

O diretório src/main/java espelha a hierarquia de pacotes: uma classe declarada como package com.example; fica em src/main/java/com/example/. Isso não é apenas uma convenção — o compilador Java se recusa a encontrar uma classe cuja declaração package não corresponda ao caminho da pasta, portanto a estrutura de diretórios e os nomes de pacotes devem estar exatamente alinhados. Siga esse layout e todas as ferramentas Java saberão onde encontrar seu código.

Para os primeiros capítulos deste livro, você não precisa de nada disso — um único arquivo .java em qualquer pasta é suficiente para começar.

Configure o JAVA_HOME e o PATH

Se sua IDE consegue encontrar java e javac pelos menus, você não precisa mexer nas variáveis de ambiente. Mas assim que você mudar para o terminal — ou usar Maven, Gradle, Spring Boot ou qualquer ferramenta de linha de comando — elas precisam que JAVA_HOME esteja definido.

JAVA_HOME é uma variável de ambiente que aponta para a raiz da instalação do seu JDK (a pasta que contém bin/, lib/ e assim por diante). As ferramentas de build a leem para localizar o compilador e a biblioteca padrão, portanto um JAVA_HOME ausente ou incorreto é a razão mais comum para mvn ou gradle falhar logo após a instalação.

Verifique sua configuração a partir de um terminal:

java -version    # prints the runtime version, e.g. "openjdk 21.0.2"
javac -version   # prints the compiler version; should match the above
echo $JAVA_HOME  # on Windows: echo %JAVA_HOME%

Se java -version e javac -version relatarem versões diferentes, seu PATH e JAVA_HOME apontam para JDKs diferentes — corrija isso antes de compilar qualquer coisa.

Consulte Como Instalar o Java (JDK) para os trechos específicos de cada plataforma, ou use um gerenciador de versões como o SDKMAN!, que define JAVA_HOME por shell automaticamente.

Atalhos de teclado úteis

Os poucos atalhos que você usará constantemente no IntelliJ:

• Executar — Shift+F10 (Win/Linux) / Control+R (macOS)
• Depurar — Shift+F9 / Control+D
• Formatar arquivo — Ctrl+Alt+L / Cmd+Option+L
• Correção rápida — Alt+Enter / Option+Return
• Encontrar em qualquer lugar — Shift Shift (duplo toque)
• Renomear símbolo — Shift+F6

VS Code e Eclipse têm equivalentes nos respectivos menus Keymap.

O que vem a seguir

Você está pronto para escrever código. O Programa Java Hello World apresenta um primeiro programa completo linha por linha, e Como Compilar e Executar um Programa Java mostra o que acontece por baixo dos panos quando sua IDE clica em Run.

Prática