Como Criar uma Configuração de Execução no IntelliJ IDEA (Guia Completo e Atualizado 2026)

Criar uma Run Configuration no IntelliJ IDEA é uma etapa essencial para rodar projetos Java, Spring Boot, Kotlin e outras aplicações de forma organizada, rápida e profissional.

Neste guia atualizado para 2026, você vai aprender passo a passo, com exemplos práticos, como criar e salvar configurações de execução sem nunca perder suas preferências ao trocar de branch no Git.

---

🔥 O que é uma Configuração de Execução no IntelliJ?

Uma Run/Debug Configuration é um conjunto de parâmetros que definem como sua aplicação será executada:

• Classe principal (Main class)

• Argumentos de execução

• Variáveis de ambiente

• Diretório de trabalho

• SDK utilizado

• Perfis Spring

• Flags especiais de testes

• Argumentos de VM

• Configurações salvas no projeto ou localmente

Ter essas configurações organizadas evita retrabalho e traz mais velocidade ao desenvolvimento.

---

🧭 1. Como Criar uma Configuração de Execução no IntelliJ (Passo a Passo)

Acesse o gerenciador de configurações

1. No canto superior direito do IntelliJ, clique na setinha ao lado do botão Run.

2. 
   Clique em Edit Configurations….

Você verá a tela semelhante à da imagem:

---

Crie uma nova configuração

1. Clique no botão + (canto superior esquerdo).

1. Escolha o tipo de configuração:

Para projetos Java comuns

Selecione Application.

Para projetos Spring Boot

Selecione Spring Boot.

Para projetos Maven ou Gradle

Selecione:

• Maven

• Gradle

Dependendo da tecnologia usada.

---

Preencha os campos essenciais

Assim que você criar a configuração, o IntelliJ solicitará informações importantes.

Nome da configuração

Coloque um nome claro, como:

• Rodar API Local

• Execução DEV

• Spring Boot – Perfil QA

 Main Class

Clique no ícone de busca e escolha a classe que contém:

public static void main(String[] args)

Ou, no caso do Spring:

@SpringBootApplication

Module

Escolha o módulo correto do projeto (geralmente IntelliJ detecta sozinho).

---

🧪 2. Configurações Avançadas: Program Arguments, Environment Variables e Working Directory

Program arguments

Aqui vão argumentos que sua aplicação recebe na linha de comando.

Exemplos úteis:

--spring.profiles.active=dev
--server.port=8082
--enableMock=true

Environment variables

Clique em Environment Variables → ... para adicionar variáveis como:

DB_HOST=localhost
DB_USER=admin
API_KEY=123456

Essa é uma área crítica para testes locais, microservices e APIs.

---

📌 4. Exemplos Práticos de Configurações

 Exemplo: Aplicação Java Simples

• Tipo: Application

• Main class: com.meuprojeto.Main

• Module: app

• SDK: Java 21

• Program args: (vazio)

 Exemplo: Spring Boot com perfil de desenvolvimento

Program arguments:
--spring.profiles.active=dev
--server.port=8081

Exemplo: API que usa variáveis de ambiente

Environment variables:
DB_HOST=localhost;DB_USER=dev;DB_PASS=123

Experimente agora mesmo criar sua primeira configuração usando este tutorial.