Oii, Gabrielly.
Isso acontece bastante quando a gente baixa o .jar manualmente. O IntelliJ não “mostra um item chamado Gson” no “+”. Você precisa apontar para o arquivo .jar que baixou ou melhor ainda, deixar o Maven/Gradle trazer a dependência automaticamente. Seguem as três formas, rapidinho:
- (Recomendado) Usando Maven
Se seu projeto tem pom.xml:
Abra o pom.xml.
Adicione dentro de <dependencies>:
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.11.0</version>
</dependency>
No IntelliJ: Maven (aba à direita) → botão Reload All Maven Projects (ou ícone de atualizar).
Dica: depois de sincronizar, verifique se aparece External Libraries > Maven: com.google.code.gson:gson:2.11.0.
- Usando Gradle
Se seu projeto tem build.gradle (Groovy):
dependencies {
implementation 'com.google.code.gson:gson:2.11.0'
}
Ou em build.gradle.kts (Kotlin DSL):
dependencies {
implementation("com.google.code.gson:gson:2.11.0")
}
Depois, Sync Now quando o IntelliJ pedir (ou clique no ícone do elefante → Reload All Gradle Projects).
- (Manual) Adicionando o .jar baixado
Se você realmente quer usar o arquivo .jar que baixou no Maven Repository:
Confirme que o arquivo é algo como gson-2.11.0.jar (não baixe “sources” ou “javadoc”).
No IntelliJ:
UI nova: File → Settings → Build, Execution, Deployment → Libraries → + → Java → selecione o .jar → OK → marque o módulo do seu projeto quando perguntar “Add to Modules”.
UI clássica: File → Project Structure (Ctrl+Alt+Shift+S)
- Vá em Libraries → + → Java → escolha o .jar → OK → aplique.
- Em Modules → Dependencies, confirme que a library está listada (Scope “Compile”/“Implementation”).
Se você clicou no + e “não aparece Gson”: é normal — você precisa navegar até a pasta onde salvou o .jar e selecionar o arquivo. O IntelliJ não lista por nome de biblioteca, ele lista arquivos.
Teste rápido no código
Depois de adicionar a dependência, este pequeno teste deve compilar:
import com.google.gson.Gson;
public class Main {
public static void main(String[] args) {
var gson = new Gson();
String json = gson.toJson(new Pessoa("Ana", 30));
System.out.println(json); // {"nome":"Ana","idade":30}
}
}
class Pessoa {
String nome;
int idade;
Pessoa(String nome, int idade) { this.nome = nome; this.idade = idade; }
}
Se import com.google.gson.Gson; continuar “vermelho”, veja os itens abaixo.
Checklist de solução de problemas
- SDK/JDK no módulo: File → Project Structure → Project e Modules → Dependencies: selecione um Project SDK (JDK 17, por exemplo).
- Rebuild: Build → Rebuild Project.
- Sincronização: em Maven/Gradle, rode o Reload/Sync.
- Escopo da dependência: em Modules → Dependencies, o Gson deve estar com Compile/Implementation, não “Test”.
- Pasta correta: se for
.jar, confirme que selecionou o gson-*.jar, não o -sources.jar/-javadoc.jar. - Invalidate Caches (casos teimosos): File → Invalidate Caches… → Invalidate and Restart.
- Estrutura do projeto: assegure que seu código está dentro de
src/main/java (Maven/Gradle) ou na pasta marcada como Sources (azul) no IntelliJ.
Conte com o apoio da comunidade Alura na sua jornada. Abraços e bons estudos!
`