Como Instalar o Kotlin no Windows em 2026: Guia Passo a Passo | Kotlin Brasil

Instalar o Kotlin no Windows em 2026 é mais simples do que muita gente imagina, mas o caminho certo depende do que você quer fazer. Quem está começando a aprender a linguagem só precisa do IntelliJ IDEA Community, que já vem com Kotlin embutido. Quem vai criar apps Android precisa do Android Studio. Quem prefere terminal pode usar Scoop, Chocolatey ou WSL com SDKMAN!. Em todos os casos, o JDK é o pré-requisito que mais confunde iniciantes — e é de longe a causa número um de “Kotlin não funciona”.

Este guia cobre todas as formas de instalar o Kotlin no Windows em 2026, com passo a passo para cada perfil. Se você busca um panorama geral para Windows, Mac e Linux, confira também o nosso artigo de referência sobre como instalar o Kotlin. Este texto foca especificamente em Windows e nos perrengues reais que aparecem por aqui.

Resposta rápida: qual caminho escolher?

Antes do passo a passo, escolha pelo seu objetivo:

A regra prática é simples: se você está em dúvida, instale o IntelliJ IDEA Community. Ele detecta o JDK, cria um projeto Kotlin/JVM pronto e roda o Main.kt sem você mexer no PATH. O resto deste guia entra nos detalhes.

Pré-requisitos: o JDK antes do Kotlin

Kotlin roda na JVM, então antes de instalar qualquer coisa relacionada a Kotlin, instale o JDK. A versão recomendada em 2026 é o JDK 21 (LTS), embora o JDK 17 também funcione bem. Distribuições confiáveis para Windows incluem Eclipse Temurin, Microsoft Build of OpenJDK, Amazon Corretto e Oracle JDK.

Baixe o instalador .msi da distribuição escolhida e marque a opção de configurar a variável JAVA_HOME e adicionar o java ao PATH automaticamente. Essa caixinha economiza horas de dor de cabeça.

Para conferir pelo PowerShell, abra o terminal e rode:

java -version

A saída esperada mostra a versão do Java, algo como:

openjdk version "21.0.5" 2024-10-15
OpenJDK Runtime Environment Temurin-21.0.5+11 (build 21.0.5+11)
OpenJDK 64-Bit Server VM Temurin-21.0.5+11 (build 21.0.5+11, mixed mode, sharing)

Se o comando retornar java não é reconhecido como um comando interno ou externo, o JDK não está no PATH. Veja a seção sobre configurar o JAVA_HOME mais abaixo — quase todo “Kotlin não instala no Windows” começa aqui.

Opção 1: IntelliJ IDEA Community (recomendado)

Para a maioria dos usuários de Windows, este é o caminho mais rápido e com menos erros. O IntelliJ IDEA Community é gratuito, já traz o Kotlin embutido e cria projetos prontos para rodar.

1. Acesse jetbrains.com/idea/download.
2. Baixe a Community Edition (gratuita; a Ultimate é paga).
3. Rode o instalador .exe e aceite as opções padrão.
4. Abra o IntelliJ e clique em New Project.
5. Escolha Kotlin no painel esquerdo e Kotlin/JVM no modelo.
6. Confirme que o JDK 21 aparece no seletor de SDK (se não, clique em Add SDK → JDK e aponte para a pasta de instalação).
7. Clique em Create e rode o arquivo Main.kt com o botão verde.

Pronto. Sem configurar PATH, sem baixar compilador manualmente. O IntelliJ cuida de tudo. Para escolher bem o editor conforme o seu caso, vale ler qual é a melhor IDE para programar em Kotlin.

Opção 2: Android Studio (para desenvolvimento Android)

Se o seu foco é criar aplicativos Android, pule o IntelliJ e instale o Android Studio, que é baseado no IntelliJ mas traz o Android SDK, o emulador e a integração com Gradle voltada para mobile.

1. Acesse developer.android.com/studio.
2. Baixe o instalador para Windows.
3. Siga o assistente de configuração, que já instala o Android SDK e uma versão do JDK embutida.
4. Crie um novo projeto Empty Activity com Kotlin.
5. Rode no emulador ou em um dispositivo físico com depuração USB ativada.

O Android Studio já vem com Kotlin configurado por padrão, então não há passo extra. Para um passo a passo detalhado, veja o tutorial de Kotlin com Android Studio e o guia de desenvolvimento Android. Quem pensa em carreira mobile também pode conferir como é o Kotlin para Android na prática.

Opção 3: linha de comando com Scoop ou Chocolatey

Se você gosta de terminal e quer o compilador kotlinc disponível no PowerShell, os gerenciadores de pacote do Windows são a melhor opção. Escolha um dos dois — Scoop é mais leve e recomendado para devs; Chocolatey é mais tradicional e instalado em muitos ambientes corporativos.

Instalar o Kotlin com Scoop

Primeiro instale o Scoop (se ainda não tem) no PowerShell:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

Depois instale o Kotlin:

scoop install kotlin
kotlin -version

Instalar o Kotlin com Chocolatey

O Chocolatey exige PowerShell como administrador:

Set-ExecutionPolicy Bypass -Scope Process -Force
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

Em uma nova janela de PowerShell como administrador:

choco install kotlin -y
kotlin -version

Ambos colocam kotlinc no PATH. Lembre-se: eles instalam o compilador Kotlin, mas não o JDK. O JDK precisa estar instalado e configurado antes.

Opção 4: WSL 2 com SDKMAN! (para quem vive no terminal)

Muitos desenvolvedores no Windows preferem o WSL 2 porque ele reproduz o ambiente Linux dentro do Windows e facilita a troca de versão do Kotlin e do JDK. É a escolha comum para quem trabalha com backend Kotlin, scripts e automação.

1. Abra o PowerShell como administrador e instale o WSL:

   wsl --install
   

2. Reinicie o computador se solicitado e abra o Ubuntu (a distro padrão).
3. Dentro do WSL, instale o SDKMAN! e o Kotlin:

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

A vantagem do WSL é que o sdk use kotlin <versão> permite alternar versões por projeto, o que é útil quando você contribui em repositórios com toolchains diferentes. A desvantagem é o custo de contexto entre sistemas de arquivos: mantenha o projeto dentro do sistema de arquivos do Linux (~/projetos) em vez de /mnt/c/ para evitar lentidão.

Configurando o JDK manualmente (JAVA_HOME e PATH)

Se o java -version não funciona depois de instalar o JDK, o problema é o PATH. Para corrigir pelo Windows:

1. Abra Editar as variáveis de ambiente do sistema (pesquise no Menu Iniciar).
2. Clique em Variáveis de Ambiente.
3. Em Variáveis do sistema, clique em Novo e crie:
   • Nome: JAVA_HOME
   • Valor: o caminho da instalação do JDK, por exemplo C:\Program Files\Eclipse Adoptium\jdk-21.0.5.9-hotspot
4. Encontre a variável Path nas variáveis do sistema, clique em Editar e adicione uma nova entrada:
   • %JAVA_HOME%\bin
5. Mova essa entrada para o topo da lista (evita conflito com um Java antigo do Windows).
6. Confirme tudo, feche e abra novamente o PowerShell e teste de novo.

java -version
echo $env:JAVA_HOME
where.exe java

O where.exe java deve mostrar o caminho dentro da pasta bin do JDK que você configurou. Se ainda aparecer um java antigo em C:\Windows\System32, é o shim legado do Windows — basta priorizar o %JAVA_HOME%\bin no topo do PATH.

Verificando a instalação e rodando o primeiro programa

Depois de instalar o Kotlin por qualquer um dos caminhos acima, valide com:

kotlin -version
kotlinc -version

A saída mostra a versão do compilador Kotlin. Em seguida, crie um arquivo Ola.kt:

fun main() {
    println("Kotlin instalado com sucesso no Windows!")
    println("Versão do Java: ${System.getProperty("java.version")}")
}

Compile e rode pelo terminal:

kotlinc Ola.kt -include-runtime -d ola.jar
java -jar ola.jar

Se você instalou pelo IntelliJ, é só clicar no botão verde ao lado de fun main(). Para entender a estrutura básica da linguagem depois desse primeiro contato, o tutorial do primeiro programa em Kotlin é o próximo passo natural.

Erros comuns ao instalar o Kotlin no Windows

• kotlinc não é reconhecido como um comando: o compilador não está no PATH. Se instalou por Scoop/Chocolatey, abra uma nova janela do PowerShell; se baixou manualmente, adicione a pasta kotlinc\bin ao PATH.
• java não é reconhecido como um comando: o JDK não está instalado ou não está no PATH. Configure JAVA_HOME conforme a seção acima.
• Versão errada do JDK: Kotlin 2.x exige JDK 8+ para rodar, mas muitos projetos em 2026 usam JDK 17 ou 21. Erros do tipo unsupported class file version costumam indicar um JDK antigo no PATH. Rode java -version e corrija a ordem do PATH.
• Execution Policy bloqueando o Scoop/Chocolatey: o PowerShell bloqueia scripts por padrão. Use Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser antes de instalar o Scoop.
• Dois JDKs conflitando: o Windows pode herdar um java.exe em C:\Windows\System32. Priorize %JAVA_HOME%\bin no topo do PATH.
• Android Studio sem reconhecer o JDK: o Android Studio traz um JDK embutido (JBR), mas projetos podem exigir outro. Configure em File → Project Structure → SDK Location.
• Arquivos de projeto dentro de /mnt/c/ no WSL lentos: mantenha o código dentro do sistema de arquivos do Linux (~/) no WSL.

E o VS Code?

O Kotlin no VS Code em 2026 ganhou suporte oficial da JetBrains em fase Alpha via Kotlin Language Server. É uma opção viável para quem já vive no VS Code e quer editar Kotlin para backend ou scripts, mas para Android e para iniciantes o IntelliJ ou o Android Studio continuam sendo a escolha mais madura.

Próximos passos

Com o Kotlin instalado no Windows, o melhor é fixar a versão da linguagem dentro de cada projeto usando o Gradle e seu wrapper (gradlew), em vez de depender do compilador global. Assim todo o time compila com a mesma versão. Veja o tutorial de Gradle com Kotlin e a comparação entre Gradle Kotlin DSL vs Groovy para entender o build.gradle.kts.

Depois, explore o ecossistema a partir do seu objetivo: backend com Spring Boot e Kotlin ou apps Android com Jetpack Compose. Para quem veio de outra linguagem, vale lembrar que o setup de toolchain é um tema recorrente: a comunidade Go Brasil, por exemplo, trata a instalação do Go no Windows de forma parecida — instalar o runtime, configurar GOPATH e validar pelo terminal — então a disciplina de JDK e PATH aqui transfere direto para outras stacks.

Conclusão

Instalar o Kotlin no Windows em 2026 não tem mistério quando você separa o JDK do compilador. Para a maioria das pessoas, o IntelliJ IDEA Community resolve tudo em minutos; para Android, o Android Studio; para terminal, Scoop ou Chocolatey; para quem quer o ambiente Linux completo, WSL 2 com SDKMAN!. O segredo é tratar o JDK como pré-requisito, configurar o JAVA_HOME e validar com java -version antes de tocar em qualquer ferramenta de Kotlin. Feito isso, é só criar o primeiro projeto e começar a programar.