Створення першого проєкту в IntelliJ IDEA

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?

1. Компіляція коду — компілятор Kotlin перетворює ваші файли .kt на байт-код .class.
2. Запуск JVM — віртуальна машина Java стартує й шукає точку входу: fun main().
3. Виконання — інструкції виконуються, а результат виводиться у вікно консолі.

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).