
Для нового проекта Java в IntelliJ IDEA рекомендуется использовать JDK 17 или выше. При создании проекта важно сразу выбрать систему сборки: Maven обеспечивает удобное управление зависимостями и интеграцию с CI/CD, Gradle ускоряет сборку и поддерживает кастомные скрипты. Для большинства проектов подойдет структура Maven по умолчанию с папками src/main/java для исходного кода и src/test/java для тестов.
В процессе создания проекта необходимо задать корректный модульный путь и указать имя модуля в файле module-info.java, если проект модульный. Это позволяет IDE автоматически проверять зависимости и совместимость версий библиотек. Для интеграции тестирования рекомендуется сразу подключить JUnit 5 через Maven или Gradle, что упрощает написание и запуск тестов.
Настройка артефактов сборки выполняется через меню Project Structure, где указываются выходные директории и зависимости. Включение опции Build automatically ускоряет процесс компиляции и снижает вероятность ошибок при запуске приложения. Рекомендуется также сразу настроить кодировку UTF-8 и версию компилятора Java, чтобы избежать проблем с совместимостью на разных машинах.
Установка и настройка JDK для нового проекта

Скачайте JDK версии 17 или выше с официального сайта Oracle или используйте OpenJDK. Для Windows рекомендуется архив ZIP без установщика, чтобы вручную задать переменные среды.
Распакуйте JDK в каталог без пробелов, например: C:\Java\jdk-17 на Windows или /usr/lib/jvm/jdk-17 на Linux. Убедитесь, что структура содержит папки bin, lib и include.
На Windows настройте переменные среды: добавьте путь к bin в PATH и создайте JAVA_HOME с точным путем к корню JDK. На Linux добавьте export JAVA_HOME=/usr/lib/jvm/jdk-17 и export PATH=$JAVA_HOME/bin:$PATH в ~/.bashrc или ~/.zshrc.
В IntelliJ IDEA откройте File → Project Structure → Project → Project SDK → Add → JDK и выберите путь к установленной JDK. Для новых проектов указывайте SDK на уровне проекта, чтобы модульные настройки наследовали версию Java автоматически.
Проверьте корректность установки через File → Settings → Build, Execution, Deployment → Compiler → Java Compiler, где должна отображаться выбранная версия JDK для компиляции. Запуск тестового класса с System.out.println(System.getProperty("java.version")) подтвердит использование нужной версии.
Выбор типа проекта и шаблона в IntelliJ IDEA

После выбора типа проекта необходимо определить шаблон. IntelliJ IDEA предлагает несколько опций: пустой проект (Empty Project), проект с настройками по умолчанию (Create project from template), или шаблоны для популярных фреймворков, например JavaFX или Spring Boot. Для изучения Java оптимально начинать с пустого проекта, чтобы вручную настроить структуру каталогов и зависимости.
Если проект предполагает использование системы сборки, лучше сразу выбирать Maven или Gradle. При выборе Maven IDEA создаст pom.xml с базовой структурой, а Gradle – build.gradle с возможностью добавления плагинов и зависимостей. Это упрощает последующее подключение библиотек и управление версионированием.
Для JavaFX-проектов шаблон автоматически создаёт модуль с базовой конфигурацией, включая файл Main.java и sample.fxml. Это ускоряет старт разработки визуальных приложений и минимизирует ручное создание файлов.
При выборе шаблона следует учитывать архитектуру проекта: для консольных утилит подходит пустой проект с классом Main, для веб-приложений – Maven/Gradle с зависимостями на сервлеты или Spring. После выбора типа и шаблона IDEA создаст структуру каталогов: src/main/java для исходников и src/test/java для тестов, что соответствует стандарту Maven и Gradle.
Рекомендуется также сразу настроить версию языка Java и кодировку файлов в настройках проекта, чтобы избежать конфликтов при компиляции и интеграции с внешними библиотеками.
Настройка структуры каталогов и модулей

После создания проекта в IntelliJ IDEA важно сразу определить корректную структуру каталогов и модулей. Это обеспечивает правильное управление зависимостями и удобство навигации.
Рекомендуемая структура Java-проекта:
- src/main/java – исходный код приложения.
- src/main/resources – ресурсы проекта (конфигурационные файлы, шаблоны, изображения).
- src/test/java – тестовые классы.
- src/test/resources – ресурсы для тестов.
Создание модулей выполняется через меню File → Project Structure → Modules → +. Для каждого модуля укажите:
- Имя модуля, соответствующее функциональной области.
- Путь к корню модуля, если используется отдельный каталог.
- Тип модуля: Java, Maven, Gradle, в зависимости от сборочной системы.
Для каждого модуля обязательно назначьте source root и test source root:
- Правый клик по папке → Mark Directory as → Sources Root для исходного кода.
- Правый клик по тестовой папке → Mark Directory as → Test Sources Root.
Если проект использует Maven или Gradle, структура каталогов должна соответствовать стандарту src/main/java и src/test/java, иначе IntelliJ IDEA не сможет корректно распознавать пакеты и зависимости.
После настройки каталогов рекомендуется открыть Project Settings → Modules → Dependencies и проверить, что каждый модуль имеет нужные зависимости и SDK. Это предотвращает ошибки компиляции и проблемы с автодополнением.
Создание первого класса и метода main

Для создания класса выполните следующие шаги:
- В панели проекта выберите директорию
src. - Щелкните правой кнопкой мыши и выберите New → Java Class.
- В поле Name введите имя класса, например
MainApp. Рекомендуется использовать PascalCase для имени класса. - Нажмите OK, чтобы создать класс.
После создания класса IntelliJ IDEA откроет редактор кода с пустым шаблоном класса:
public class MainApp {
}
Чтобы добавить метод main, используйте следующую структуру:
public static void main(String[] args) {
// код программы
}
Рекомендации при написании метода main:
- Метод должен быть
publicиstatic, чтобы JVM могла его вызвать без создания экземпляра класса. - Параметр
String[] argsиспользуется для передачи аргументов из командной строки.
Пример минимальной рабочей программы:
public class MainApp {
public static void main(String[] args) {
System.out.println("Программа запущена успешно!");
}
}
Для запуска программы щелкните правой кнопкой мыши на файле класса и выберите Run ‘MainApp.main()’. IntelliJ IDEA создаст конфигурацию запуска автоматически.
Подключение внешних библиотек и зависимостей

В IntelliJ IDEA подключение внешних библиотек реализуется через системы сборки Maven или Gradle, либо вручную через структуру проекта. Для Maven необходимо добавить зависимости в файл pom.xml, используя координаты групповой идентификации, артефакта и версии. Например, подключение библиотеки Gson:
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.10.1</version>
</dependency>
После сохранения IDEA автоматически загрузит артефакт из центрального репозитория Maven и внесет его в classpath проекта.
Для Gradle зависимости добавляются в секцию dependencies файла build.gradle. Пример для той же библиотеки:
dependencies {
implementation 'com.google.code.gson:gson:2.10.1'
}
Для ручного подключения JAR-файлов необходимо:
| Шаг | Описание |
|---|---|
| 1 | Открыть Project Structure (Ctrl+Alt+Shift+S) и перейти в раздел Libraries. |
| 2 | Нажать ‘+’ → Java и выбрать путь к JAR-файлу. |
| 3 | Назначить библиотеку конкретным модулям проекта. |
| 4 | Применить изменения, IDEA добавит JAR в classpath. |
Важно использовать версии библиотек, совместимые с текущей версией JDK проекта. Для Maven и Gradle рекомендуется включать управление версиями через свойства проекта, чтобы облегчить обновление зависимостей.
Для контроля конфликтов версий внешних библиотек в Maven используется <dependencyManagement>, а в Gradle – resolutionStrategy. Это предотвращает ошибки компиляции из-за несовместимых JAR-файлов.
Запуск и проверка работоспособности проекта

После создания проекта в IntelliJ IDEA убедитесь, что структура папок соответствует стандарту Maven или Gradle: исходный код должен находиться в папке src/main/java, ресурсы – в src/main/resources. Откройте главный класс с методом public static void main(String[] args).
Для запуска проекта используйте сочетание клавиш Shift+F10 или кнопку «Run» в верхней панели. IntelliJ автоматически скомпилирует код и создаст конфигурацию запуска, если она ещё не настроена. Проверяйте наличие ошибок компиляции в панели «Messages».
Если программа завершилась с ошибкой Exception или Error, откройте «Run» → «Edit Configurations» и проверьте аргументы командной строки, рабочую директорию и зависимости проекта. Перекомпилируйте проект через Build → Rebuild Project перед повторным запуском.
Для автоматической проверки работоспособности можно подключить JUnit-тесты. Создайте пакет src/test/java, напишите тестовые методы с аннотацией @Test и запустите их через «Run All Tests». Это позволит выявить скрытые ошибки до выполнения основного кода.
Вопрос-ответ:
Как создать новый проект Java в IntelliJ IDEA с нуля?
Для начала откройте IntelliJ IDEA и на стартовом экране выберите «Создать проект». В открывшемся окне укажите тип проекта «Java» и версию JDK, которая будет использоваться. Затем задайте имя проекта и путь к каталогу, где он будет храниться. После этого можно выбрать структуру проекта — с использованием системы сборки (например, Maven или Gradle) или без нее. Нажав «Готово», вы получите пустой проект, готовый к добавлению классов и пакетов.
Можно ли создать проект Java без указания JDK?
Технически создать проект без JDK не получится, так как среда разработки требует компилятор для Java-кода. Однако на этапе создания проекта можно выбрать «Проект без JDK» и позже привязать нужную версию Java в настройках проекта через File → Project Structure → Project SDK.
В чем разница между проектом с Gradle и обычным Java-проектом?
Главное отличие заключается в управлении зависимостями и сборке. В обычном Java-проекте все библиотеки подключаются вручную, а структура проекта проще. В Gradle-проекте сборка автоматизирована: зависимости указываются в build.gradle, и среда сама скачивает и подключает нужные библиотеки. Это удобно для больших проектов или при работе с внешними библиотеками, но новичкам иногда сложнее понять структуру.
Как добавить новый класс после создания проекта?
Щелкните правой кнопкой мыши по папке src → New → Java Class. В появившемся окне введите имя класса и выберите его тип: класс, интерфейс, перечисление или аннотация. После этого новый файл появится в структуре проекта, и его можно сразу редактировать.
Что делать, если IntelliJ IDEA не видит установленный JDK при создании проекта?
Сначала убедитесь, что JDK действительно установлен на компьютере. В настройках IntelliJ IDEA откройте File → Project Structure → SDKs и проверьте, есть ли версия Java. Если ее нет, добавьте путь к установленной JDK вручную. После этого при создании проекта выбранная версия станет доступна.
