--- title: "Como Instalar o Kotlin no Windows em 2026: Guia Passo a Passo | Kotlin Brasil" url: "https://kotlin.dev.br/blog/instalar-kotlin-windows-2026/" markdown_url: "https://kotlin.dev.br/blog/instalar-kotlin-windows-2026.MD" description: "Aprenda como instalar o Kotlin no Windows em 2026: IntelliJ IDEA, Android Studio, Scoop, Chocolatey, WSL e SDKMAN!. Configure JDK, PATH e rode seu primeiro programa Kotlin." date: "2026-07-05" author: "Karina Melo" --- # Como Instalar o Kotlin no Windows em 2026: Guia Passo a Passo | Kotlin Brasil Aprenda como instalar o Kotlin no Windows em 2026: IntelliJ IDEA, Android Studio, Scoop, Chocolatey, WSL e SDKMAN!. Configure JDK, PATH e rode seu primeiro programa Kotlin. 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](/perguntas/como-instalar-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: | Objetivo no Windows | Instalação recomendada | Tempo médio | |---|---|---| | Aprender Kotlin do zero | IntelliJ IDEA Community | 10 min | | Criar app Android | Android Studio | 30 min | | Usar `kotlinc` no PowerShell | Scoop ou Chocolatey | 15 min | | Reproduzir setup Linux/macOS | WSL 2 + SDKMAN! | 25 min | | Testar sem instalar nada | Kotlin Playground | 1 min | 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: ```powershell java -version ``` A saída esperada mostra a versão do Java, algo como: ```powershell 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](https://www.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](/perguntas/melhor-ide-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](https://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](/tutoriais/kotlin-android-studio/) e o [guia de desenvolvimento Android](/guias/guia-kotlin-android-desenvolvimento/). Quem pensa em carreira mobile também pode conferir como é o [Kotlin para Android](/blog/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: ```powershell Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression ``` Depois instale o Kotlin: ```powershell scoop install kotlin kotlin -version ``` ### Instalar o Kotlin com Chocolatey O Chocolatey exige PowerShell como administrador: ```powershell 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: ```powershell 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: ```powershell 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: ```bash 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 ` 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. ```powershell 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: ```powershell kotlin -version kotlinc -version ``` A saída mostra a versão do compilador Kotlin. Em seguida, crie um arquivo `Ola.kt`: ```kotlin fun main() { println("Kotlin instalado com sucesso no Windows!") println("Versão do Java: ${System.getProperty("java.version")}") } ``` Compile e rode pelo terminal: ```powershell 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](/tutoriais/primeiro-programa-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](/blog/kotlin-vscode-alpha-guia-pratico-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](/tutoriais/kotlin-gradle-tutorial/) e a comparação entre [Gradle Kotlin DSL vs Groovy](/comparacoes/gradle-kotlin-vs-groovy/) para entender o `build.gradle.kts`. Depois, explore o ecossistema a partir do seu objetivo: backend com [Spring Boot e Kotlin](/tutoriais/kotlin-spring-boot-tutorial/) 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.