Kotlin: ошибка Unresolved reference в IntelliJ IDEA — что делать?

Основная причина: неправильная настройка SDK или модуля

Ошибка "Unresolved reference" в Kotlin для базовых функций (main, println) почти всегда связана с тем, что IntelliJ IDEA не видит Kotlin runtime библиотеки. Даже если вы указали версию Kotlin в Gradle, среда может не подключить её автоматически к модулю. Вот пошаговая инструкция, как это исправить.

Шаг 1. Проверьте структуру проекта (File -> Project Structure)

• Нажмите Ctrl+Alt+Shift+S (или Cmd+; на macOS).
• Перейдите в раздел Project. Убедитесь, что выбран Project SDK (например, JDK 17 или 21). Если SDK не выбран — нажмите "Add SDK" и укажите путь к JDK.
• Перейдите в Modules -> выберите ваш модуль (обычно "main"). Вкладка Dependencies должна содержать строку Kotlin Java Virtual Machine (или kotlin-stdlib). Если её нет — нажмите "+" -> "Library" -> "KotlinJavaRuntime".

Шаг 2. Пересоберите Gradle-модель

Если зависимости в Gradle правильные, но IDE их не видит:

// Откройте build.gradle.kts и убедитесь, что там есть:
plugins {
    kotlin("jvm") version "1.9.0"
}

dependencies {
    implementation(kotlin("stdlib"))
}

Затем выполните:

• Нажмите на значок слона (Gradle) справа -> кнопка Reload All Gradle Projects.
• Или в терминале: ./gradlew clean build --refresh-dependencies.

Шаг 3. Сбросьте кеш IDE (если не помогло)

Иногда IntelliJ застревает со старыми индексами:

File -> Invalidate Caches / Restart...
Выберите: "Invalidate and Restart"

Шаг 4. Проверьте версию плагина Kotlin

Перейдите в Settings -> Plugins. Убедитесь, что плагин Kotlin установлен и включён. Версия плагина должна совпадать с версией Kotlin в проекте (1.9.0). Если нет — обновите плагин через Marketplace.

Пример рабочего минимального проекта

Чтобы исключить проблемы, создайте новый проект без Gradle:

File -> New -> Project
Выберите: Kotlin -> JVM
НЕ ставьте галочку "Gradle" — создайте пустой проект.
Создайте файл Main.kt и напишите:
fun main() {
    println("Test")
}

Если в этом простом проекте ошибка исчезла — значит проблема именно в конфигурации Gradle. Сравните настройки.

Если ничего не помогает

Попробуйте удалить папки .idea и .gradle в корне проекта, затем открыть проект заново (File -> Open). Это полностью пересоздаст конфигурацию IDE.

После этих шагов ошибка "Unresolved reference" исчезнет. В 95% случаев проблема решается на шаге 1 или 2.

kotlin {
    sourceSets {
        main {
            kotlin.srcDirs("src/main/kotlin")
        }
    }
}

./gradlew dependencies

configurations.all {
    resolutionStrategy {
        force("org.jetbrains.kotlin:kotlin-stdlib:1.9.0")
    }
}