 |
| Por que o IntelliJ perde configurações ao trocar de branch? |
Quando você trabalha com Git dentro do IntelliJ IDEA, é comum alternar entre
branches ou até mesmo remover branches locais.
O problema é que, em muitos projetos Java, o IntelliJ armazena configurações específicas da branch dentro da pasta .idea — incluindo:
Versão do JDK usado
Configuração do Project SDK
Configuração de Linguagem (Java 8, 11, 17…)
Estrutura de módulos
Web settings (Spring Boot, Maven, WAR, etc.)
Code Style, inspeções e mapeamentos
Se essa pasta .idea ou o arquivo *.iml for alterado, sobrescrito ou removido, o IntelliJ “perde” todas as definições e abre o projeto como se fosse novo.
Isso explica por que ao remover ou trocar a branch, suas configurações somem.
A boa notícia: existem 3 formas de impedir que o IntelliJ apague configurações ao mexer nas branches.
No seu .gitignore, garanta que estes itens estejam excluídos:
Assim, suas configurações ficam locais, e não vão ser sobrescritas quando mudar de branch.
💡 Importante: o Maven e o IntelliJ irão recriar automaticamente o projeto quando necessário.
Vá em:
File → Project Structure → Platform Settings → SDKs
E configure:
JDK desejado
Nome padrão
Pasta fixa do Java no seu sistema
Depois vá em:
File → Settings → Build Tools → Maven → Runner → JRE
Selecione "Use External JDK" e aponte para o Java instalado.
Isso faz o IntelliJ usar o mesmo SDK para todos os projetos, mesmo que a branch troque arquivos internos.
Vá em:
File → Settings for New Projects
E defina:
Project SDK
Language level
Encoding
Frameworks (Spring, Maven, Lombok, etc.)
Assim, sempre que o IntelliJ “reabrir” o projeto, ele recriará com esses padrões.
A branch antiga tinha arquivos .idea que são diferentes
Você usa “git checkout .” que sobrescreve o .idea
O IntelliJ está configurado para reimportar o Maven automaticamente
O projeto foi clonado novamente e perdeu metadados
A solução definitiva é:
✔ Ignorar arquivos do IntelliJ no Git
✔ Fixar o SDK globalmente no IntelliJ
✔ Configurar os padrões globais para novos projetos
Com isso, mesmo que você apague, recrie ou troque branches, as configurações do ambiente não somem mais.
Configurações IntelliJ apagando, IntelliJ perde configurações ao trocar branch, IntelliJ Git branch settings, Java SDK IntelliJ sumindo, IntelliJ IDEA 2025 tutorial, erro IntelliJ branch, .idea git ignore.
