Клонирование репозитория с GitHub в IntelliJ IDEA

Клонирование репозитория — это создание полной локальной копии проекта вместе с историей коммитов и связью с удалённым репозиторием (remote). В отличие от скачивания ZIP-архива, клонированный проект можно обновлять командой git pull и отправлять в него свои изменения. В этом уроке разберём весь путь: регистрация на GitHub, установка Git, подключение аккаунта к IntelliJ IDEA, клонирование репозитория и публикация собственного проекта.

Регистрация на GitHub

Если аккаунт уже есть, переходите сразу к установке Git.

1. Откройте github.com и нажмите кнопку Sign up.

2. Укажите e-mail, придумайте пароль и имя пользователя (username). На почту придёт письмо с кодом подтверждения — введите его, чтобы активировать аккаунт.

Имя пользователя попадёт в адреса всех ваших репозиториев (https://github.com/username/project.git), поэтому лучше выбрать короткий и нейтральный вариант — его увидят в резюме и на собеседовании.

Установка Git

IntelliJ IDEA не содержит Git внутри себя — она вызывает системный исполняемый файл. Поэтому Git нужно поставить отдельно.

• Windows: скачайте установщик на gitforwindows.org, запустите .exe и пройдите мастер с настройками по умолчанию.
• macOS: выполните brew install git или установите Xcode Command Line Tools командой xcode-select --install.
• Linux: sudo apt install git (Debian/Ubuntu) или sudo dnf install git (Fedora).

После установки откройте терминал (в Windows — Git Bash или командную строку) и проверьте версию:

git --version

Если в ответ появилась строка вида git version 2.46.0, установка прошла успешно. Сразу задайте имя и почту — они подставляются в каждый коммит:

git config --global user.name "Ivan Petrov"
git config --global user.email "[email protected]"

Подключение аккаунта GitHub к IntelliJ IDEA

1. Откройте Settings (Ctrl+Alt+S, на macOS Cmd+,) и перейдите в раздел Version Control. Внутри находятся два нужных пункта: Git и GitHub.

2. Откройте Version Control → Git и проверьте поле Path to Git executable. Обычно IDEA определяет путь сама; если поле пустое, укажите вручную (C:\Program Files\Git\bin\git.exe в Windows, /usr/bin/git в Linux и macOS). Кнопка Test покажет определённую версию Git.

3. Откройте Version Control → GitHub и нажмите + (Add account).

4. Выберите способ входа. Пароль от аккаунта здесь больше не подходит — доступны три варианта:

Токен создаётся в GitHub: Settings → Developer settings → Personal access tokens. Для работы из IDE нужны права (scopes) repo, read:org, gist и workflow. Токен показывается один раз — сохраните его сразу.

Как скачать проект с GitHub: клонирование репозитория

Скачать проект с GitHub в IntelliJ IDEA можно тремя способами — результат одинаковый.

Способ 1. С экрана приветствия

Если открытых проектов нет, IDEA показывает экран приветствия. Нажмите Clone Repository (в версиях 2020.3–2022.x кнопка называется Get from VCS).

Способ 2. Из открытого проекта

Выберите File → New → Project from Version Control (или Git → Clone в главном меню).

В обоих случаях откроется одно и то же окно. В поле URL вставьте адрес репозитория, например https://github.com/milkina/java-core.git. В поле Directory укажите папку на диске, куда ляжет проект, и нажмите Clone. IDEA скачает репозиторий вместе с историей коммитов и откроет его в новом окне.

Адрес репозитория берётся на его странице в GitHub: зелёная кнопка Code → вкладка HTTPS → иконка копирования.

Способ 3. Через командную строку

Тот же результат даёт одна команда в терминале, после чего папку можно открыть через File → Open:

git clone https://github.com/milkina/java-core.git
cd java-core
git log --oneline -5

Последняя команда выведет пять последних коммитов — так вы убедитесь, что скачалась именно рабочая копия с историей, а не просто набор файлов.

Настройка проекта после клонирования

Дальнейшие шаги нужны только для проектов без системы сборки — когда в репозитории нет pom.xml или build.gradle. Такие учебные проекты хранят настройки модулей внутри IDE, поэтому после клонирования их приходится задавать вручную.

1. Выделите корневой каталог в окне Project, нажмите F4 (или правая кнопка мыши → Open Module Settings).

2. В разделе Project проверьте SDK. Если он не задан, нажмите Add SDK → JDK и укажите путь к установленной JDK. В поле Language level выберите уровень, соответствующий выбранной JDK.

3. Откройте Modules → Sources и пометьте каталог src как Sources, а каталог resources — как Resources. Без этого IDEA не считает .java-файлы исходным кодом и подсвечивает их как обычный текст.

4. Во вкладке Paths выберите Use module compile output path и укажите каталог out внутри проекта — туда попадут скомпилированные .class-файлы.

Как загрузить свой проект на GitHub

Обратная задача — выложить локальный проект в удалённый репозиторий. Из IntelliJ IDEA это делается без создания репозитория на сайте вручную.

1. Откройте проект и выберите Git → GitHub → Share Project on GitHub (в старых версиях: VCS → Import into Version Control → Share Project on GitHub).
2. Задайте имя репозитория, при необходимости отметьте Private и добавьте описание.
3. В окне Add Files For Initial Commit снимите галочки с папок out, target, build и .idea — скомпилированные файлы и локальные настройки IDE в репозитории не нужны.
4. Нажмите Add. IDEA создаст репозиторий на GitHub, сделает первый коммит и отправит его (push).

Дальше изменения отправляются привычной парой действий: Commit (Ctrl+K) и Push (Ctrl+Shift+K).

Если что-то пошло не так

Четыре сообщения, на которых спотыкаются чаще всего:

Итоги

Теперь у вас есть аккаунт на GitHub, установленный Git и IntelliJ IDEA, подключённая к вашему аккаунту. Вы умеете скачивать чужой проект клонированием (с полной историей, а не ZIP-архивом), настраивать его после клонирования и публиковать собственный код на GitHub. Это базовый набор для работы в команде: дальше остаются коммиты, ветки, pull request и разрешение конфликтов.