Resposta rápida: sim, dá para programar Kotlin no VS Code em 2026 usando a extensão oficial Kotlin by JetBrains, ainda em fase Alpha. O fluxo recomendado é instalar um JDK, abrir a raiz do projeto Gradle no editor e usar ./gradlew test ou ./gradlew build como validação. VS Code funciona bem para estudos, scripts, backend pequeno e monorepos poliglotas; para Android, Compose, refatorações grandes e projetos Gradle complexos, prefira Android Studio ou IntelliJ IDEA.
O suporte oficial muda a conversa para uma linguagem historicamente associada às IDEs da JetBrains. Agora existe um caminho mais claro para quem trabalha em APIs, ferramentas internas, automações ou equipes que já usam VS Code como editor principal — sem confundir um editor mais leve com paridade total de recursos.
Este guia mostra como instalar e configurar Kotlin no VS Code, quais comandos usar, os cenários em que a escolha faz sentido e os limites que você precisa conhecer antes de adotá-lo no projeto.
O que mudou para Kotlin no VS Code?
Até pouco tempo atrás, usar Kotlin no VS Code era possível, mas frequentemente irregular. Você dependia de extensões comunitárias, configuração manual de linguagem, Gradle rodando no terminal e pouca integração real com o compilador.
Com o movimento oficial da JetBrains em torno de uma extensão Kotlin para VS Code, a experiência fica mais séria para tarefas como:
- abrir projetos Kotlin sem trocar imediatamente de editor;
- editar código com suporte de linguagem mais consistente;
- experimentar Kotlin em ambientes onde VS Code já é padrão;
- trabalhar em repositórios mistos com Kotlin, JavaScript, Python, YAML, Terraform e documentação;
- reduzir a barreira de entrada para quem está vindo de Java ou backend web.
Isso não elimina o papel do IntelliJ IDEA. Ele continua sendo a referência para refatorações profundas, navegação complexa, integração Gradle madura e produtividade diária em bases grandes. O ponto é que Kotlin deixa de parecer uma linguagem presa a uma única IDE.
Como instalar Kotlin no VS Code em 2026
Você precisa de três peças: JDK, extensão oficial e um projeto com build reproduzível. A extensão melhora a experiência de edição, mas não instala Java nem substitui Gradle.
1. Instale e confirme o JDK
Use a versão exigida pelo projeto. JDK 17 e JDK 21 são bases comuns em projetos JVM atuais, mas o arquivo de build ou a documentação do repositório deve ser a fonte de verdade.
No terminal integrado do VS Code, confirme:
java -version
Se o comando não existir ou mostrar uma versão incompatível, corrija o JAVA_HOME antes de investigar a extensão. Em projetos Android, também confira a versão de Java compatível com o Android Gradle Plugin usado pelo repositório.
2. Instale a extensão Kotlin by JetBrains
Abra Extensions com Ctrl+Shift+X no Windows/Linux ou Cmd+Shift+X no macOS, pesquise por Kotlin by JetBrains e confirme que o publicador é a JetBrains. Como o suporte está em Alpha, leia as notas da versão antes de padronizá-lo para todo o time.
Evite instalar várias extensões Kotlin com funções sobrepostas ao mesmo tempo. Se autocomplete, diagnóstico ou navegação se comportarem de forma inconsistente, desative as extensões comunitárias antigas e teste novamente somente com a opção oficial.
3. Abra a raiz do projeto Gradle
No VS Code, abra a pasta que contém pelo menos um destes arquivos:
settings.gradle.kts
build.gradle.kts
gradlew
gradlew.bat
Abrir apenas src/main/kotlin remove o contexto que o editor e as ferramentas precisam para entender módulos, dependências e versão da linguagem.
4. Valide pelo Gradle Wrapper
No Linux e macOS:
./gradlew test
./gradlew build
No Windows PowerShell:
.\gradlew.bat test
.\gradlew.bat build
Se esses comandos passam, você tem uma base confiável mesmo quando algum diagnóstico do editor falha. Se não passam, resolva primeiro JDK, dependências ou configuração Gradle; trocar de extensão raramente corrige um build quebrado.
Quando VS Code faz sentido para Kotlin?
VS Code pode ser uma boa escolha quando o projeto Kotlin é enxuto, quando o repositório é poliglota ou quando você quer aprender a linguagem sem mudar todo o ambiente de trabalho.
Exemplos realistas:
- uma API pequena em Ktor ou Spring Boot com Kotlin;
- scripts
.ktspara automação local; - bibliotecas JVM internas com poucos módulos;
- exercícios de linguagem, coleções, null safety e testes;
- manutenção pontual em um monorepo onde Kotlin é apenas uma parte;
- revisão de código Kotlin em times que usam VS Code no restante da stack.
Também faz sentido para quem está comparando Kotlin com outras linguagens modernas. Se você já está avaliando Kotlin vs Java em 2026, testar Kotlin no editor atual pode diminuir o atrito inicial.
Quando preferir IntelliJ IDEA ou Android Studio?
Para muitos projetos profissionais, especialmente no começo de 2026, IntelliJ IDEA e Android Studio continuam sendo escolhas mais seguras.
Prefira IntelliJ IDEA quando você precisa de:
- refatorações grandes entre módulos;
- inspeções Kotlin e Java mais completas;
- navegação profunda em projetos Gradle complexos;
- integração forte com testes, cobertura e debugging;
- produtividade alta em Kotlin para backend;
- suporte mais maduro para KSP, annotation processing e plugins.
Prefira Android Studio quando o projeto envolve:
- Android nativo;
- Jetpack Compose;
- previews de interface;
- emulador, Logcat, profiler e ferramentas do Android SDK;
- Hilt, Room, Navigation, WorkManager e testes instrumentados;
- publicação, signing e diagnóstico de builds Android.
O VS Code pode abrir e editar arquivos Android, mas isso não significa que ele seja o melhor ambiente para desenvolver um app Android completo. Para esse cenário, veja também o guia de desenvolvimento Android com Kotlin e o artigo sobre Hilt no Android com Kotlin.
Setup mínimo recomendado
Para evitar uma experiência frustrante, não comece apenas instalando uma extensão e abrindo uma pasta qualquer. Monte um fluxo mínimo e verificável.
1. Instale JDK e Gradle wrapper
Projetos Kotlin reais normalmente devem usar o Gradle Wrapper do próprio repositório:
./gradlew --version
Isso confirma qual versão de Gradle, JVM e Kotlin Gradle Plugin o projeto usa. Em times brasileiros, esse detalhe evita o clássico “funciona na minha máquina” quando uma pessoa usa JDK 17, outra JDK 21 e outra JDK 24 sem perceber.
2. Abra a raiz correta do projeto
Abra no VS Code a pasta onde ficam settings.gradle.kts, build.gradle.kts ou gradlew. Se você abrir uma subpasta isolada, a extensão pode não enxergar corretamente os módulos.
Um projeto simples pode ter este formato:
meu-servico-kotlin/
gradlew
settings.gradle.kts
build.gradle.kts
src/
main/kotlin/br/dev/Servico.kt
test/kotlin/br/dev/ServicoTest.kt
Em monorepos, vale criar uma workspace do VS Code apontando para a parte Kotlin e os arquivos compartilhados relevantes, em vez de abrir um repositório gigantesco sem critério.
3. Use o terminal como fonte de verdade
Mesmo com suporte de IDE, mantenha os comandos de build explícitos:
./gradlew test
./gradlew build
Se o editor diz que está tudo certo, mas ./gradlew build falha, o build está falhando. Para projetos de backend, esse hábito combina bem com os guias de CI/CD com Kotlin e Gradle em Kotlin.
Exemplo: projeto Kotlin JVM pequeno
Um build.gradle.kts mínimo para estudos ou ferramenta interna pode começar assim:
plugins {
kotlin("jvm") version "2.2.0"
application
}
repositories {
mavenCentral()
}
dependencies {
testImplementation(kotlin("test"))
}
application {
mainClass.set("br.dev.MainKt")
}
E um arquivo Main.kt:
package br.dev
fun main() {
val linguagens = listOf("Kotlin", "Java", "TypeScript")
linguagens
.filter { it.startsWith("K") }
.forEach { println("Estudando $it") }
}
No VS Code, a edição deve ser confortável. No terminal, a validação continua simples:
./gradlew run
./gradlew test
Esse tipo de projeto é uma boa porta de entrada para aprender collections em Kotlin, funções de extensão e null safety sem carregar todo o peso de um app Android.
Cuidado com projetos Kotlin Multiplatform
Kotlin Multiplatform é um caso especial. Mesmo quando o código comum parece simples, o projeto pode envolver alvos JVM, Android, iOS, desktop, web ou Wasm. Isso aumenta a dependência de Gradle, plugins e tarefas específicas.
VS Code pode ajudar na edição, mas a decisão precisa considerar:
- quantos targets o projeto compila;
- se há código iOS com CocoaPods, Swift Package Manager ou Xcode;
- se há Compose Multiplatform;
- se a equipe depende de previews, refatorações e depuração por target;
- se o build local roda com estabilidade no terminal.
Para entender melhor esse cenário, leia também Kotlin Multiplatform, nova estrutura de projetos KMP e Compose Multiplatform para iOS em produção.
Fluxo recomendado para times
Se sua equipe quer adotar Kotlin no VS Code, trate isso como decisão de fluxo, não como preferência pessoal de editor.
Um caminho seguro:
- Defina JDK, Gradle Wrapper e versão Kotlin no repositório.
- Documente os comandos mínimos:
test,build,rune lint quando existir. - Valide se a extensão atende navegação, autocomplete e diagnósticos básicos.
- Mantenha IntelliJ IDEA ou Android Studio como fallback para refatorações grandes.
- Evite misturar migração de editor com migração de arquitetura.
O erro comum é tentar resolver tudo ao mesmo tempo: migrar Java para Kotlin, trocar IDE, alterar build, mudar arquitetura e introduzir coroutines na mesma semana. Faça em etapas.
Se o objetivo é migração, comece pelo artigo sobre converter Java para Kotlin no VS Code e depois aprofunde em Kotlin para desenvolvedores Java.
Checklist rápido
Antes de apostar em VS Code para um projeto Kotlin, responda:
- O projeto compila com
./gradlew buildsem depender da IDE? - A equipe sabe qual JDK usar?
- Os módulos Kotlin são pequenos o suficiente para navegação confortável?
- As refatorações principais já foram feitas ou ainda estão por vir?
- Há Android, Compose ou Multiplatform complexo envolvido?
- Existe fallback claro para IntelliJ IDEA ou Android Studio?
Se a maioria das respostas favorece simplicidade, VS Code pode ser uma opção prática. Se o projeto é grande, Android-heavy ou cheio de plugins, comece pelo ambiente JetBrains e use VS Code como apoio.
Perguntas frequentes sobre Kotlin no VS Code
Dá para rodar Kotlin no VS Code sem Gradle?
Dá para compilar arquivos simples com ferramentas de linha de comando, mas projetos profissionais se beneficiam de Gradle ou Maven para declarar versão do Kotlin, dependências, testes e tarefas reproduzíveis. Para começar sem criar a estrutura manualmente, veja como instalar Kotlin no Windows ou siga o primeiro programa em Kotlin.
A extensão oficial funciona com projetos Java e Kotlin juntos?
Esse é um dos cenários mais interessantes, porque Kotlin tem interoperabilidade com Java e muitos projetos JVM usam as duas linguagens. Ainda assim, valide navegação, diagnósticos e execução no seu repositório antes de adotar o editor como padrão. Se o objetivo é migração, o guia para converter Java para Kotlin no VS Code mostra por que conversão automática ainda exige revisão humana.
Qual é a melhor IDE para Kotlin iniciante?
IntelliJ IDEA Community costuma ser a opção mais completa para aprender Kotlin na JVM, enquanto Android Studio é a escolha natural para Android. VS Code faz sentido quando você já conhece seu fluxo, prefere um editor leve ou trabalha em um repositório com várias linguagens. A comparação detalhada está em qual é a melhor IDE para Kotlin.
VS Code serve para Kotlin backend com Ktor ou Spring Boot?
Sim, especialmente quando o serviço é pequeno, o build roda de forma independente e a equipe usa terminal para testes. Em bases grandes, recursos mais maduros de navegação, debugging e integração com frameworks podem justificar IntelliJ IDEA. Compare os caminhos no guia de Kotlin para backend.
Conclusão
Kotlin no VS Code em 2026 é uma oportunidade real para ampliar o alcance da linguagem, principalmente em backend, automação, aprendizado e repositórios poliglotas. A novidade é importante porque reduz atrito, não porque torna as IDEs JetBrains irrelevantes.
Para uma pessoa desenvolvedora brasileira, a melhor decisão é pragmática: use VS Code quando ele acelerar o trabalho sem esconder problemas de build; use IntelliJ IDEA ou Android Studio quando o projeto exigir refatoração, Android, Compose, Gradle complexo ou depuração mais profunda.
Kotlin fica mais forte quando você escolhe a ferramenta pelo contexto do projeto, não pela torcida por um editor.