Criação do primeiro projeto no IntelliJ IDEA

1. Criação de um novo projeto passo a passo

Um projeto no IntelliJ IDEA — não é apenas uma pasta com arquivos, mas um contêiner completo em que a IDE guarda tudo o que está relacionado ao seu futuro programa. Em um projeto ficam:

• código-fonte (arquivos com extensão .java);
• configurações do projeto (por exemplo, qual versão do Java usar);
• bibliotecas externas (se forem necessárias);
• arquivos e recursos auxiliares.

Dentro do projeto geralmente há a pasta src — é o local principal para seus arquivos Java. Tudo o que não diz respeito ao código é armazenado separadamente e não atrapalha o trabalho.

Iniciando o IntelliJ IDEA

Na tela inicial, clique no grande botão azul New Project.

Configuração dos parâmetros do projeto

Vamos passar pelos campos principais de cima para baixo:

• Name: o nome do seu projeto. Esse nome também será usado para criar a pasta no disco.
• Location: o caminho no computador onde o projeto será armazenado. Por padrão, a IDEA sugere sua pasta IdeaProjects. Deixe como está.
• Create Git repository: permite inicializar imediatamente o sistema de controle de versão Git para o projeto. Nesta etapa, para não complicar, deixe essa caixa desmarcada.
• Build system: o sistema de build é a ferramenta que automatiza o processo de compilação do código, o gerenciamento de dependências e a criação do aplicativo pronto:
  • IntelliJ: sistema de build embutido da IDEA. Nossa escolha.
  • Maven/Gradle: sistemas de build poderosos e independentes; 99% dos projetos reais usam um deles.
• Add sample code: a IDEA criará automaticamente a estrutura básica do projeto e uma classe com o método main.

Instalação do JDK pelo IntelliJ IDEA

Chegamos ao momento de instalar o JDK.

• Como ainda não o instalamos, a lista estará vazia. Nossa tarefa é baixá-lo diretamente daqui.

1. Clique na lista suspensa e selecione a opção Download JDK...

2. Uma pequena janela será aberta:

• Version: escolha da versão do Java. Nosso curso suporta a versão 25.
• Vendor: fornecedor da distribuição. Como combinamos anteriormente, escolha Amazon Corretto.
• Location: o caminho para onde a IDEA fará o download e instalará esse JDK. Você pode deixar o valor padrão.

3. Clique no botão Select.

Todas as configurações foram feitas. Clique em Create.

O IntelliJ IDEA começará a baixar o JDK escolhido, depois criará a estrutura do projeto e abrirá a janela principal do editor. Será preciso aguardar alguns minutos.

Na primeira execução, você pode ver no canto inferior direito uma notificação da IDEA sugerindo ajustar o seu antivírus, por exemplo, “Microsoft Defender may affect IDE performance”. Clique sem medo no botão Exclude folders. O IntelliJ IDEA adicionará automaticamente a pasta do projeto e suas pastas de sistema à lista de exclusões do seu antivírus.

Ao iniciar o programa pela primeira vez, você verá um banner informando sobre a ativação do período de teste gratuito do Ultimate. Esta é a saudação padrão na nova versão unificada do IntelliJ IDEA.

Esta notificação apenas confirma que agora você tem acesso temporário ao Ultimate, mas para o nosso curso, este é um complemento opcional.

2. Visão geral rápida da IDEA

Então, criamos um novo projeto. Vamos entender o que estamos vendo aqui.

1. Project — a janela principal para navegar pela estrutura do projeto.

2. Arquivo atualmente aberto Main.java

3. Botões para Run ▶ (execução) e Debug (depuração) do programa

4. Menu lateral

• Services — a guia usada para gerenciar serviços externos; no início, você não vai precisar dela.
• Terminal — a linha de comando (console) do seu sistema operacional (Windows, macOS, Linux) embutida diretamente na IDE.
• Problems — o painel exibe erros de compilação e avisos durante a escrita do código. A IDEA analisa seu código em tempo real e sublinha pontos problemáticos, muitas vezes oferecendo correções automáticas.
• Git — ícone no formato de diagrama ramificado. Esse painel é destinado ao trabalho com o sistema de controle de versão Git.

3. Estrutura do projeto

Agora vamos olhar com mais atenção a janela de estrutura do projeto à esquerda. O IntelliJ IDEA criou para nós alguns arquivos e pastas importantes.

• .idea — é a pasta de serviço do IntelliJ IDEA. Nela ficam as configurações específicas deste projeto.
  Você não deve alterar essa pasta manualmente nem enviá-la para outros desenvolvedores. Ela é individual para cada usuário.
• src — a pasta mais importante em qualquer projeto Java. O nome é uma abreviação de “sources” (fontes). É exatamente aqui que ficará todo o seu código.
  • Main.java — como marcamos a opção “Add sample code”, a IDEA criou este arquivo para nós. É uma classe Java com o “ponto de entrada” do programa — o método public static void main(String[] args). A execução de qualquer programa Java começa por ele.
• .gitignore — é o arquivo de configuração do sistema de controle de versão Git.
• External Libraries — não é uma pasta real, mas uma representação virtual de todas as bibliotecas externas conectadas ao projeto. No momento, há apenas uma, mas a mais importante biblioteca — nosso JDK.

4. Execução do programa

A parte mais agradável é executar o programa e ver o resultado do seu trabalho (e não apenas erros).

Na parte superior da janela, clique no botão Run ▶. À esquerda dele está escrito o nome do arquivo que será executado (no nosso caso, Current File):

Alternativa: clique com o botão direito no arquivo ▶ Run Run 'Main.main()'.

Você verá o resultado da execução do programa

Comando de execução (em vermelho) — é o comando que o IntelliJ IDEA formou e passou ao sistema operacional para iniciar o programa.

Isto é uma chamada direta do executável java.exe daquele JDK que baixamos. É esse arquivo que inicia a Máquina Virtual Java (JVM). Todo o restante da linha após java.exe são parâmetros de serviço.

Saída do programa (em azul) — é o resultado útil do seu código.

Código de saída (em verde) Process finished with exit code 0. Essa mensagem é o relatório final sobre como o programa foi encerrado.

• Por convenção, exit code 0 significa que o programa executou com sucesso todas as suas instruções do início ao fim e terminou normalmente, sem erros.
• Qualquer outro código sinaliza que ocorreu um erro durante a execução.

Sempre preste atenção a essa linha. Ela é o seu principal indicador de se o programa “caiu” ou finalizou corretamente.

Além disso, após a primeira execução, apareceu uma nova pasta out na estrutura do projeto à esquerda. Nela ficam os arquivos compilados .class — o bytecode que a JVM executa.

Parabéns! Você acabou de escrever e executar seu primeiro programa em Java em uma IDE profissional.

Como funciona a execução do programa na IDEA

Quando você clica em Run, acontece o seguinte:

1. A IDEA compila seu código — transforma .java em .class (bytecode para a JVM).
2. A JVM é iniciada — a máquina virtual Java começa a executar o programa a partir do método main.
3. O resultado é exibido — tudo o que for impresso por System.out.println aparece no console.

Toda essa mágica acontece com poucos cliques — não é preciso chamar o compilador manualmente nem procurar onde o arquivo foi salvo.

5. IntelliJ IDEA keyboard shortcuts

O IntelliJ IDEA tem atalhos de teclado para a maioria dos comandos relacionados a edição, navegação, refatoração, depuração e outras tarefas. Memorizar esses atalhos ajuda você a trabalhar de forma mais produtiva, sem tirar as mãos do teclado.

Você pode ver as combinações de atalhos na documentação da JetBrains, com a possibilidade de escolher o sistema operacional

Ou consultar diretamente na própria IDEA. Menu-Help-Keyboard shortcuts PDF.

6. Erros ao criar o primeiro projeto

Criou o arquivo Java fora da pasta src

No mundo Java existe um acordo rígido: a pasta src — é a raiz de onde “nascem” todos os fontes do seu projeto. A IDE e os sistemas de build esperam encontrar o código exatamente ali.

Incompatibilidade entre os nomes da classe e do arquivo
O arquivo deve ter o mesmo nome da classe (respeitando maiúsculas e minúsculas!). Por exemplo, Main.java para a classe Main. Se você nomear o arquivo main.java (com letra minúscula), o compilador vai reclamar.

Main method ausente ou escrito incorretamente
O método deve ser exatamente public static void main(String[] args). Um único erro de digitação — e o programa não será executado.

JDK não selecionado para o projeto
Se, ao criar o projeto, o JDK não for selecionado ou o caminho estiver errado, a IDEA não conseguirá compilar o projeto. Verifique as configurações em File → Project Structure → Project SDK.

Espaços e cirílico no caminho
Embora os sistemas modernos sejam bem mais tolerantes, a regra de ouro continua valendo: os caminhos para projetos e para o JDK não devem conter caracteres cirílicos, espaços ou caracteres especiais. É melhor usar apenas letras latinas e sublinhados.

Executando a classe errada
Se você tiver várias classes com o método main, certifique-se de executar o arquivo correto (clique com o botão direito → ▶ Run).