1. Пошаговое создание нового проекта
Проект в IntelliJ IDEA — это не просто папка с файлами, а целый контейнер, в котором IDE хранит всё, что связано с вашей будущей программой. В проекте лежат:
- исходный код, файлы с расширением .kt;
- настройки проекта, например, какую версию Java Virtual Machine использовать для запуска;
- внешние библиотеки;
- вспомогательные файлы и ресурсы.
Внутри проекта обычно есть папка src — это основное место для ваших Kotlin-файлов. Всё, что не относится к коду, хранится отдельно и не мешает работе.
Запускаем IntelliJ IDEA
На стартовом экране нажмите на большую синюю кнопку New Project. Если уже открыт другой проект, нажмите File-New Project
Настройка параметров проекта
Обратите внимание на левое меню окна: там обязательно должен быть выбран язык Kotlin, по умолчанию там стоит Java. Теперь пройдемся по основным полям:
- Name: имя вашего проекта. Это имя также будет использоваться для создания папки на диске. Можно оставить
untitled1или написать другое, пускай будетMyFirstProject. - Location: путь, где на компьютере будет храниться проект. По умолчанию IDEA предлагает свою папку
IdeaProjects. Оставляем как есть. - Create Git repository: позволяет сразу инициализировать систему контроля версий Git. На данном этапе, чтобы не усложнять, оставьте эту галочку пустой.
- Build system: система сборки — это инструмент, который автоматизирует процесс компиляции кода:
- IntelliJ: встроенная, самая простая система сборки IDEA. Наш выбор для старта.
- Gradle: мощная система сборки, стандарт де-факто в мире Kotlin. Но для обучения сейчас он избыточен. Использовать его сейчас — это как забивать гвозди микроскопом.
- Add sample code: IDEA автоматически создаст для нас базовый файл с функцией
mainи примером кода. - Use compact project structure: оставляет структуру папок простой и плоской, без избыточных вложенностей.
Установка JDK из IntelliJ IDEA
Если список JDK пуст, наша задача — скачать его прямо отсюда.
1. Нажмите на выпадающий список и выберите опцию Download JDK...
2. Перед вами откроется небольшое окно:
- Version: выбор версии Java. Наш курс отлично работает с современными LTS-версиями, выбираем 25.
- Vendor: поставщик дистрибутива. Как мы и договаривались, выбираем Amazon Corretto, но можно использовать и другой.
- Location: путь, куда IDEA скачает и установит этот JDK. Оставляем по умолчанию.
3. Нажмите кнопку Select или Download.
Все настройки сделаны. Нажимайте Create.
IntelliJ IDEA начнет скачивать выбранный JDK, после чего создаст структуру проекта и откроет главное окно редактора. Внизу экрана может появиться надпись Indexing... — это IDE читает файлы, чтобы помогать вам подсказками. Просто подождите минутку.
При первом запуске на Windows вы можете увидеть уведомление: "Microsoft Defender may affect IDE performance". Смело нажимайте Automatically или Exclude folders. IDEA добавит папку с проектом в исключения антивируса, чтобы сборка кода работала быстро.
Пробный период Ultimate
При первом открытии редактора вы можете увидеть большое окно или баннер: "Your free Ultimate subscription trial is active".
Не пугайтесь, ничего платить не нужно. Новая единая версия IDEA дает вам доступ ко всем функциям на 30 дней. Для нашего курса нам вполне достаточно бесплатных возможностей, поэтому вы можете просто закрыть это окно.
2. Краткий обзор и первый код
В IntelliJ IDEA можно быстро менять масштаб всего интерфейса, не копаясь в настройках: Alt + Shift + = или в настройках Settings -- View -> Appearance -> Zoom IDE .
Перед вами открылся редактор кода с файлом Main.kt.
1. Боковое меню
2. Project основное окно для перемещения по структуре проекта.
3. Текущий открытый файл Main.kt
4. Кнопки для Run ▶ запуск и Debug программы
IDEA сгенерировала для нас пример кода с полезными подсказками — TIPs. Давайте посмотрим на него:
Разбор кода
Код выглядит немного сложнее, чем просто "Hello World", но он отлично демонстрирует мощь Kotlin:
//TIPs ...— это советы и шорткаты.val name = "Kotlin"— мы создали переменнуюname. Заметьте, нам не пришлось писать тип переменной, Kotlin сам догадался.println(...)— вывод текста на экран.for (i in 1..5)— это цикл. Код внутри фигурных скобок выполнится 5 раз (для чисел от 1 до 5).println("i = $i")— магия Kotlin! Символ$позволяет вставить значение переменнойiпрямо внутрь строки.
Красный круг на полях слева или иконка в коде — это точка входа в режим отладки (debug). О ней мы поговорим в позже. Если вы случайно поставили такую точку, просто кликните по ней еще раз, чтобы убрать.
Функции верхнего уровня
Просто знайте, разбираться сейчас не нужно.
Обратите внимание: функция main не завернута ни в какой class. В Kotlin это называется Top-Level Function. Если функция не принадлежит конкретному объекту, она может жить прямо в файле .kt.
Поскольку JVM требует классы, компилятор Kotlin при запуске сам создаст невидимый класс (обычно MainKt), так что все технические требования соблюдены.
3. Структура проекта
Внимательнее посмотрим на структуру проекта слева.
-
.idea— служебная папка IntelliJ IDEA с настройками проекта. Её не нужно изменять вручную. -
src— самая главная папка! Сокращение от "sources" - исходники. Именно здесь будет лежать весь ваш Kotlin-код.-
Main.kt— так как мы просили добавить "sample code", IDEA создала этот файл. Внутри него находится функцияfun main(). Это "точка входа" — именно с неё начинается выполнение любой программы.
-
-
External Libraries— виртуальная папка, где отображаются подключенные библиотеки. Сейчас там находится наш JDK и стандартная библиотека Kotlin/JVM.
4. Запуск программы
Самое приятное — запустить код и увидеть результат. В Kotlin есть отличный и безопасный способ запускать конкретный файл.
Найдите в редакторе кода функцию fun main(). Слева от неё, на полях с номерами строк (в так называемом gutter), есть зелёный треугольник ▶. Нажмите на него и выберите Run 'MainKt'.
Внизу откроется окно Run/Console, и вы увидите результат выполнения программы:
Разберем вывод:
Команда запуска (серая служебная строка в самом начале) — это путь к JVM, который IDEA сформировала для запуска вашего скомпилированного кода.
Вывод программы (обычный текст) — это результат работы ваших println().
Код завершения: Process finished with exit code 0. Это финальный отчет. По соглашению, exit code 0 означает, что программа успешно выполнила все инструкции и завершилась без ошибок. Любой другой код означает, что программа "упала" в процессе работы.
Кроме того, после первого запуска в проекте появится скрытая папка out. В ней лежат скомпилированные .class файлы — тот самый байт-код Kotlin, который исполняет JVM.
Что происходит при нажатии Run?
- Компиляция кода — компилятор Kotlin превращает ваши
.ktфайлы в байт-код.class. - Запуск JVM — виртуальная машина Java стартует и ищет точку входа:
fun main(). - Выполнение — инструкции выполняются, и результат выводится в окно консоли.
5. Alt + Enter и горячие клавиши
Работая в IntelliJ IDEA, вы заметите серый текст-подсказку прямо в редакторе: "Press Alt Enter... to see how IntelliJ IDEA suggests fixing it".
Сочетание Alt + Enter или Option + Enter на macOS — это ваша главная волшебная палочка. Если IDE подчеркнула код красным (ошибка) или желтым (предупреждение), поставьте туда курсор и нажмите эти клавиши. IDEA не просто объяснит проблему, но и предложит варианты автоматического исправления.
Также IDE поддерживает множество других шорткатов для навигации и отладки. Их можно посмотреть в документации JetBrains или прямо в меню IDEA: Help -> Keyboard Shortcuts PDF.
6. Типичные ошибки и как их избежать
Иллюзия «зависшей программы»
Если вы написали в коде функцию readln(), при запуске в консоли не появится никакого текста, а будет просто мигать курсор. Новички часто думают, что IDEA зависла. На самом деле программа просто ждет вашего ввода. Кликните мышкой в окно консоли Run, напечатайте текст и нажмите Enter.
Запускается "не тот" main (Run Configurations)
Если вы создадите в проекте второй файл Test.kt и напишете там еще один fun main(), у вас появится две точки входа. Если после этого нажать большую кнопку Run в самом верху окна, IDEA может запустить предыдущий файл. Чтобы всегда запускать именно тот код, который вы сейчас редактируете, нажимайте зелёный треугольник ▶ слева от нужного fun main() прямо в редакторе кода.
Код написан не в папке src
Папка src — это корень исходников. Среда разработки ожидает найти Kotlin-код именно там. Если вы создадите файл .kt вне этой папки (например, в корне проекта), кнопка запуска не появится, а код не скомпилируется.
Пропущен или неправильно написан fun main()
Если вы забудете написать fun main() или назовете функцию fun myMain(), программа не запустится, так как JVM не найдет точку старта.
Не выбран JDK для проекта
Если при создании проекта вы случайно пропустили шаг с JDK, IDEA выдаст ошибку "Project SDK is not defined". Это легко исправить через настройки: File → Project Structure → Project SDK.
Кириллица и пробелы в пути к проекту
Хотя современные системы терпимее к именам, золотое правило программиста гласит: пути к проектам не должны содержать русские буквы, пробелы или спецсимволы (например, C:\Мои Проекты\Проект 1 — плохая идея). Используйте только латинские буквы и подчёркивания (C:\IdeaProjects\project_one).
ПЕРЕЙДИТЕ В ПОЛНУЮ ВЕРСИЮ