Как установить Kotlin: IntelliJ IDEA, Playground и Gradle

Чтобы начать Kotlin, не обязательно сразу ставить тяжелую среду. Для первых строк хватит Kotlin Playground. Для нормального проекта удобнее IntelliJ IDEA. Для сборки и зависимостей часто используется Gradle. В этом уроке разложим эти варианты без путаницы

Цель простая: выбрать один рабочий путь, запустить первую программу и понять, что именно установлено: язык, IDE, JDK или система сборки

Что получится в конце

У вас будет один из трех сценариев:

1. Быстрый старт в Kotlin Playground
2. Проект Kotlin в IntelliJ IDEA
3. Gradle-проект, который запускается командой

Проверка для локального проекта:

./gradlew run

или в Windows:

gradlew.bat run

Ожидаемый результат:

Hello, Kotlin

Если эта строка появилась, среда готова для первых уроков

Что выбрать новичку

Если вы хотите просто попробовать синтаксис, берите Kotlin Playground. Это браузерный редактор от Kotlin, где можно написать fun main() и нажать Run

Если вы хотите учиться серьезнее, ставьте IntelliJ IDEA Community Edition. Kotlin поддерживается прямо из коробки, а IDE помогает с подсказками, ошибками и запуском

Если вы хотите понимать проектную сборку, постепенно добавляйте Gradle. Он нужен для зависимостей, тестов, задач сборки и реальных JVM-проектов

Для Android нужен Android Studio, а не просто IntelliJ. Но Android лучше открывать после базового Kotlin, иначе в одном уроке смешаются язык, Gradle, SDK, эмулятор и Compose

Kotlin Playground: старт без установки

Откройте https://play.kotlinlang.org/ и вставьте:

fun main() {
    println("Hello, Kotlin")
}

Нажмите Run. Если вывод появился, вы уже можете проходить первые темы: val, var, функции, null safety, data class и коллекции

Ограничение Playground в том, что он не показывает весь реальный проект. Вы не увидите привычную структуру Gradle, папки src/main/kotlin, настройки JDK и работу с зависимостями. Поэтому Playground хорош для первых экспериментов, но не должен быть единственной средой надолго

IntelliJ IDEA: нормальный учебный проект

Скачивайте IntelliJ IDEA с официального сайта JetBrains. Community Edition достаточно для Kotlin/JVM-обучения

Общий порядок:

1. Установить IntelliJ IDEA
2. Создать новый Kotlin-проект или Gradle Kotlin-проект
3. Дождаться индексации и синхронизации Gradle
4. Открыть Main.kt
5. Запустить main

Минимальный файл:

fun main() {
    println("Hello, Kotlin")
}

Если рядом с main появилась кнопка запуска, IDE распознала проект. Если кнопки нет, проверьте тип проекта, JDK и завершилась ли Gradle Sync

JDK: почему Kotlin на JVM просит Java

Kotlin может компилироваться под разные платформы, но обычный учебный Kotlin/JVM работает поверх Java Virtual Machine. Поэтому локальной среде нужен JDK

Не путайте JDK и Kotlin. JDK дает Java runtime и инструменты JVM. Kotlin compiler превращает Kotlin-код в байткод для JVM. IntelliJ и Gradle помогают всем этим управлять

Проверка:

java -version

Если JDK не найден, IntelliJ может предложить скачать подходящую версию. Для новичка это нормальный путь: пусть IDE настроит JDK внутри проекта, вместо ручного копания в переменных окружения

Gradle: зачем он нужен

Gradle описывает сборку проекта. В простом Kotlin/JVM-проекте он отвечает за:

• подключение Kotlin plugin
• загрузку зависимостей
• запуск приложения
• тесты
• сборку артефакта

Типичная структура:

project/
  build.gradle.kts
  settings.gradle.kts
  src/
    main/
      kotlin/
        Main.kt

В учебном материале не нужно сразу писать Gradle-файл руками. Но полезно знать, что build.gradle.kts — это сценарий сборки, а не файл с кодом приложения

Первый запуск через Gradle

Если проект создан как Gradle application, запуск часто выглядит так:

./gradlew run

Gradle wrapper (gradlew) хорош тем, что проект сам знает, какую версию Gradle использовать. Не нужно ставить Gradle глобально на компьютер заранее

Если команда долго работает в первый раз, это нормально. Gradle скачивает зависимости и готовит кэш. Повторные запуски обычно быстрее

Домашка: сравнить три режима

Запустите один и тот же код в трех местах:

fun main() {
    val source = "Kotlin"
    println("Started from $source")
}

Сравните:

• Playground: быстрее всего начать
• IntelliJ: удобнее редактировать проект
• Gradle: ближе к реальной сборке

Запишите для себя, где именно появилась ошибка, если что-то не запустилось. Это поможет отличать ошибку Kotlin-кода от ошибки среды

Как понять, что проблема не в Kotlin-коде

Новички часто видят красный текст и думают, что не понимают Kotlin. Но часть ошибок относится к среде: JDK, Gradle, Sync, неправильная папка, зависимость, индекс IDE

Разделяйте проверки:

1. Код запускается в Playground
2. Такой же код запускается в IntelliJ
3. Gradle Sync проходит без ошибок
4. Команда запуска выполняется из папки проекта

Если код работает в Playground, но не работает в IntelliJ, проблема почти наверняка не в языке. Смотрите настройки проекта, JDK и Gradle

Мини-практика: проверить проект двумя способами

В IntelliJ запустите main зеленой кнопкой рядом с функцией. Затем откройте терминал внутри IDE и попробуйте запустить проект через Gradle

./gradlew run

Если кнопка работает, а Gradle-команда нет, проверьте, что проект создан как Gradle application и что вы находитесь в корневой папке проекта

Если Gradle работает, а кнопка нет, возможно, IDE еще не распознала run configuration или индексирует проект. Дождитесь окончания фоновых процессов

Что не нужно устанавливать на старте

Не ставьте сразу все варианты Kotlin: compiler вручную, Gradle глобально, Android Studio, IntelliJ, несколько JDK и плагины неизвестного происхождения. Чем больше инструментов поставлено без понимания, тем сложнее отлаживать первую ошибку

Для чистого старта достаточно одного пути:

• Playground для первых уроков
• IntelliJ IDEA для Kotlin/JVM
• Android Studio для Android

Gradle wrapper пусть живет внутри проекта. Это снижает риск, что глобальная версия Gradle конфликтует с проектной

Как вести учебные проекты

Создавайте отдельную папку под каждый урок: kotlin-start, kotlin-null-safety, kotlin-collections. Не складывайте все примеры в один файл Main.kt, иначе ошибки из разных тем будут мешать друг другу

После каждого урока оставляйте рабочее состояние. Если следующий эксперимент сломался, вы сможете вернуться к предыдущему проекту и сравнить. Это простая, но очень взрослая привычка в обучении

Частые ошибки и порядок проверки

No JDK configured Проект не видит JDK. Откройте настройки Project SDK в IntelliJ или примите предложение IDE скачать JDK

Gradle Sync не завершился Не запускайте проект, пока Gradle еще синхронизируется. Сначала дождитесь зеленого статуса или прочитайте первую ошибку Sync

Запускаете команду не из папки проекта ./gradlew run нужно выполнять там, где лежит gradlew и build.gradle.kts

Скачали не тот инструмент Для Kotlin/JVM подойдет IntelliJ IDEA. Для Android нужен Android Studio. Для пары строк кода достаточно Playground

Мини-чек перед следующим уроком

Перед тем как переходить к null safety, убедитесь, что у вас есть один стабильный способ запуска Kotlin-кода. Не важно, Playground это или IntelliJ, важно, чтобы вы могли повторить запуск без новой настройки каждый раз

Чек:

• вы знаете, где лежит файл с кодом
• вы понимаете, какой кнопкой или командой запускаете программу
• вы видите вывод println
• вы можете намеренно сломать код и увидеть ошибку компилятора

Если эти четыре пункта выполнены, среда не будет мешать изучать язык. Если нет, лучше потратить десять минут на настройку сейчас, чем путать ошибки Gradle с ошибками Kotlin в каждом следующем уроке

Что может быть еще интересно по этой теме

Можно ли учить Kotlin без установки? Да, первые уроки можно пройти в Playground. Но для Gradle, Android и зависимостей нужна локальная среда

IntelliJ IDEA или Android Studio? Для общего Kotlin/JVM — IntelliJ IDEA. Для Android — Android Studio, потому что там есть SDK, эмулятор, шаблоны и Android-инструменты

Нужно ли ставить Gradle отдельно? Обычно нет, если проект использует Gradle wrapper. Команда ./gradlew скачает и использует нужную версию

Когда переходить к Android? После fun main, функций, data class, коллекций и null safety. Иначе Android будет казаться сложнее, чем он есть

Что почитать дальше по Kotlin

• Kotlin с нуля: первая программа и println
• Null safety в Kotlin: ?, !! и Elvis operator
• Функции и data class в Kotlin
• Kotlin Android: первый экран без перегруза