Como Instalar Kotlin em 2026: Passo a Passo (Windows, Mac e Linux) | Kotlin Brasil

Como instalar Kotlin?

Tá pronto pra botar a mão na massa? Então bora instalar o Kotlin no seu computador. Existem várias formas de fazer isso, e vou te mostrar as principais.

Como instalar o Kotlin: escolha o caminho certo

Antes do passo a passo, escolha o caminho pelo seu objetivo:

Se você pesquisou “como instalar o Kotlin” e só quer começar rápido: instale o IntelliJ, crie um projeto Kotlin/JVM e rode o arquivo Main.kt. Se você já usa terminal, instale o JDK 21 + o SDKMAN! + o Kotlin.

Opção 1: IntelliJ IDEA (Recomendada)

A forma mais simples de começar é instalando o IntelliJ IDEA Community Edition, que é gratuito e já vem com suporte completo a Kotlin embutido:

1. Acesse jetbrains.com/idea/download
2. Baixe a Community Edition (gratuita)
3. Instale normalmente no seu sistema operacional
4. Abra o IntelliJ e crie um novo projeto Kotlin

Pronto! Sem configuração extra, sem dor de cabeça. O IntelliJ cuida de tudo pra você.

O IntelliJ também oferece recursos avançados como autocompletar inteligente, refatoração automatizada, depuração integrada e suporte nativo a Gradle. Para quem está começando, a experiência de desenvolvimento é muito superior a usar apenas um editor de texto simples. Ainda em dúvida sobre o editor? Veja qual é a melhor IDE para programar em Kotlin.

Opção 2: Android Studio (Para desenvolvimento mobile)

Se seu foco é Android, o Android Studio é o caminho:

1. Acesse developer.android.com/studio
2. Baixe e instale o Android Studio
3. Ele já vem com Kotlin configurado por padrão

O Android Studio é baseado no IntelliJ IDEA, então a experiência é bem parecida, mas com ferramentas extras voltadas para mobile: emulador de dispositivos, inspetor de layout, profiler de performance e integração com o Google Play. Se quiser um passo a passo detalhado, confira nosso tutorial de Kotlin com Android Studio e o guia de desenvolvimento Android.

Como instalar o Kotlin no Windows em 2026

Para a maioria dos usuários de Windows, o caminho mais rápido e com menos erros ainda é o IntelliJ IDEA Community Edition. Ele já traz modelos de projeto Kotlin, detecta o JDK automaticamente e cria um Main.kt executável sem você precisar editar o PATH manualmente. Se o seu objetivo é Android, use o Android Studio no lugar, porque ele instala o Android SDK, o emulador e a integração com o Gradle no mesmo fluxo.

Um setup prático no Windows fica assim:

1. Install JDK 21 from Eclipse Temurin, Microsoft Build of OpenJDK or another trusted distribution.
2. Install IntelliJ IDEA Community.
3. Create a new Kotlin/JVM project with Gradle.
4. Run the generated main function from the IDE.
5. Only after that, configure terminal usage if you really need kotlinc globally.

To check the JDK from PowerShell, run:

java -version
where java

Se o java -version falhar, resolva o Java antes de instalar as ferramentas do Kotlin. A maioria dos problemas de instalação do Kotlin no Windows é, na verdade, problema de JDK ou de PATH. Para quem trabalha muito na linha de comando, muitos desenvolvedores preferem WSL + SDKMAN!, porque ele acompanha as instruções de Linux/macOS e facilita a troca de versão.

Como instalar o Kotlin no Linux em 2026

No Linux, o SDKMAN! costuma ser melhor do que os pacotes da distribuição porque entrega versões atuais do Kotlin e do Java. Algumas distribuições vêm com um compilador mais antigo, o que confunde iniciantes quando um tutorial espera recursos mais novos da linguagem. Use os pacotes da distro apenas quando você precisa de um tooling gerenciado pelo sistema em um ambiente restrito.

Fluxo recomendado no Linux:

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk install java 21-tem
sdk install kotlin
java -version
kotlin -version

Se você está montando um projeto real de backend ou Android, não dependa para sempre de um compilador global. Deixe o Gradle fixar a versão do plugin Kotlin no build.gradle.kts e use o wrapper do projeto (./gradlew), assim todo o time compila com a mesma versão. Veja também nosso tutorial de Gradle com Kotlin e a comparação Gradle Kotlin DSL vs Groovy.

Instalar o Kotlin pela linha de comando com SDKMAN!

Dica rápida: o SDKMAN! é o instalador via linha de comando mais conveniente para Kotlin no macOS e no Linux porque gerencia versões do Kotlin e do JDK no mesmo lugar. Instale o SDKMAN!, abra um novo terminal, rode sdk install kotlin e confira com kotlin -version.

Opção 3: Linha de comando (SDKMAN!)

Pra quem curte o terminal, o SDKMAN! é a forma mais prática de gerenciar o Kotlin no macOS e Linux:

# Instalar o SDKMAN!
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# Instalar o Kotlin
sdk install kotlin

# Verificar a instalação
kotlin -version

Depois de instalado, você pode compilar e rodar arquivos Kotlin direto pelo terminal:

# Criar um arquivo
echo 'fun main() { println("Kotlin instalado com sucesso!") }' > ola.kt

# Compilar e rodar
kotlinc ola.kt -include-runtime -d ola.jar
java -jar ola.jar

A grande vantagem do SDKMAN! é que ele permite ter múltiplas versões do Kotlin instaladas ao mesmo tempo e alternar entre elas facilmente com sdk use kotlin <versão>. Isso é muito útil quando você trabalha em projetos que exigem versões diferentes.

Instalar o Kotlin no macOS com Homebrew

Se a sua intenção é especificamente instalar Kotlin com Homebrew no Mac, o Homebrew funciona bem para ter uma versão global do Kotlin. Prefira o SDKMAN! quando você precisar alternar versões por projeto.

Opção 4: Homebrew (macOS)

No macOS, se você já usa Homebrew:

brew install kotlin
kotlin -version

Simples e direto. A desvantagem em relação ao SDKMAN! é que o Homebrew gerencia apenas uma versão por vez. Se você precisa alternar entre versões, o SDKMAN! é a melhor escolha.

Opção 5: Snap (Linux)

No Linux, além do SDKMAN!, você pode instalar via Snap em distribuições que suportam esse gerenciador:

sudo snap install kotlin --classic
kotlin -version

Para distribuições baseadas em Debian/Ubuntu que preferem usar o gerenciador de pacotes nativo, verifique se o Kotlin está disponível nos repositórios oficiais da sua distro.

Opção 6: Sem instalar nada

Se quiser apenas testar a linguagem antes de instalar qualquer coisa, use o Kotlin Playground direto no navegador:

// Cole isso em play.kotlinlang.org e clique em Run
fun main() {
    val linguagem = "Kotlin"
    val versao = "2.1"

    println("$linguagem $versao rodando no navegador!")
    println("Nenhuma instalacao necessaria")
}

Acesse play.kotlinlang.org e comece a codar imediatamente. O Playground suporta até importações de bibliotecas como kotlinx.coroutines, então dá pra testar bastante coisa sem instalar nada. Para aprender sobre coroutines e funções da linguagem, o Playground é um ótimo ponto de partida.

Pré-requisitos importantes

Independente da opção escolhida, você precisa do JDK (Java Development Kit) instalado, já que Kotlin roda na JVM. (Curioso se precisa saber Java antes? Veja precisa saber Java para aprender Kotlin?.) O IntelliJ e o Android Studio geralmente cuidam disso automaticamente, mas se for usar a linha de comando:

# Instalar JDK via SDKMAN!
sdk install java 21-tem

# Verificar
java -version

A versão recomendada do JDK é a 17 ou superior (LTS). O JDK 21 é a versão LTS mais recente e funciona muito bem com Kotlin. Evite usar versões muito antigas (abaixo do 11), pois algumas funcionalidades mais novas do Kotlin podem não funcionar corretamente.

Configurando o Gradle

Para projetos mais estruturados, você vai precisar do Gradle como ferramenta de build. A boa notícia é que o IntelliJ e o Android Studio configuram o Gradle automaticamente ao criar um novo projeto. Se quiser configurar manualmente, o arquivo build.gradle.kts básico fica assim:

plugins {
    kotlin("jvm") version "2.1.0"
    application
}

repositories {
    mavenCentral()
}

dependencies {
    testImplementation(kotlin("test"))
}

application {
    mainClass.set("MainKt")
}

Temos um tutorial completo de Gradle com Kotlin que cobre tudo isso em detalhes.

Verificação rápida da instalação

Depois de instalar, rode estes comandos:

java -version
kotlin -version
kotlinc -version

Crie também um arquivo Main.kt:

fun main() {
    println("Kotlin instalado com sucesso")
}

E execute:

kotlinc Main.kt -include-runtime -d app.jar
java -jar app.jar

Se isso imprimir Kotlin instalado com sucesso, a instalação básica está funcionando. Para um primeiro projeto real, siga para primeiro programa em Kotlin ou Kotlin com Gradle.

Dicas de solução de problemas

Às vezes a instalação não sai de primeira. Aqui vão alguns problemas comuns e como resolver:

“kotlin: command not found” – Isso acontece quando o Kotlin não está no PATH do sistema. Se usou SDKMAN!, execute source "$HOME/.sdkman/bin/sdkman-init.sh" ou reinicie o terminal. No macOS com Homebrew, verifique se /opt/homebrew/bin está no seu PATH. No Windows, prefira rodar pelo IntelliJ/Gradle antes de tentar instalar kotlinc globalmente.

“Error: JAVA_HOME is not set” – O Kotlin precisa do JDK pra funcionar. Instale o JDK conforme descrito acima e configure a variável de ambiente JAVA_HOME apontando para o diretório de instalação. Em projetos Gradle, confirme também com ./gradlew -version.

Versão do Kotlin incompatível com o projeto – Se ao abrir um projeto você vê erros de compatibilidade, verifique a versão do Kotlin configurada no build.gradle.kts e certifique-se de que o JDK instalado é compatível. O IntelliJ geralmente sugere a correção automaticamente.

IntelliJ lento ou travando – Aumente a memória alocada para o IDE em Help > Change Memory Settings. Para projetos Kotlin, 2 GB de heap é um bom ponto de partida.

E agora?

Com o Kotlin instalado, o próximo passo é criar seu primeiro projeto. Recomendo começar com algo simples: uma calculadora, uma lista de tarefas ou qualquer coisa que te motive a escrever código. O importante é praticar!

Se quiser um caminho estruturado, siga esta ordem:

1. Primeiro programa em Kotlin – o famoso “Olá, mundo” e seus primeiros passos
2. Variáveis e tipos – entenda val, var e o sistema de tipos
3. Estruturas condicionais – if, when e expressões
4. Funções em Kotlin – como criar e usar funções
5. Classes e objetos – programação orientada a objetos

Aqui no Kotlin Brasil você encontra vários tutoriais e o guia completo de Kotlin pra te acompanhar nessa jornada. Se quiser um plano de estudos completo depois de instalar, veja como aprender Kotlin em 2026.