Создание локального git-репозитория в IntelliJ IDEA

Локальный git-репозиторий — это служебная папка .git внутри вашего проекта, в которой git хранит историю изменений: снимки файлов, авторов и сообщения коммитов. Репозиторий создаётся командой git init и полностью работает на вашем компьютере, без интернета. GitHub нужен на следующем шаге — чтобы отправить эту историю в облако и поделиться проектом.

Где эти пункты меню в новых версиях IntelliJ IDEA

Скриншоты в этом уроке сделаны в актуальной версии IntelliJ IDEA. Если вы работаете в версии до 2020.1 или встретили в другой инструкции старые названия пунктов меню — ниже таблица соответствия:

Шаг 1. Создание локального репозитория

Открываем свой проект в IntelliJ IDEA. Для инициализации локального git-репозитория в верхнем меню выбираем VCS → Enable Version Control Integration… (в версиях до 2020.1 этот пункт назывался VCS → Import into Version Control → Create Git Repository).

и далее Git в выпадающем списке:

После нажатия на кнопку 'Ok', внизу рядом с иконкой Git появиться надпись "Created Git repository in <ПУТЬ К КАТАЛОГУ ПРОЕКТА>":

После создания репозитория появятся два окна — Commit и Git. Если они не появились, откройте их через View → Tool Windows → Commit (Alt+0) и View → Tool Windows → Git (Alt+9). В версиях до 2020.1 это было одно окно Version Control.

Шаг 2. Добавление файлов под контроль версий

Создание репозитория само по себе ничего не отслеживает: git пока не знает, за какими файлами следить. В окне Commit нас интересует вкладка Changes. В списке Unversioned Files находятся файлы, которые не отслеживаются git; IntelliJ IDEA выделяет их коричневым:

Выбираем файлы, изменения в которых хотим отслеживать, вызываем контекстное меню и выбираем Git → Add (в версиях до 2020.1 этот пункт назывался Add to VCS):

Обычно в репозиторий добавляют исходный код (например, .java, .xml) и файлы конфигурации сборки (pom.xml, build.gradle). Скомпилированные и временные файлы (.class, папки target, out, build) коммитить не нужно — их проще один раз перечислить в .gitignore.

После добавления файл Main.java переместился в список Changes — здесь находятся отслеживаемые git файлы, которые попадут под контроль версий после коммита. Только что добавленные файлы IntelliJ IDEA выделяет зелёным:

Если проект уже находится под контролем версий, то при создании нового файла IntelliJ IDEA сама предложит добавить его в git:

Соглашаемся — нажимаем Yes.

Шаг 3. Коммит

Коммит сохраняет состояние проекта в репозиторий: git делает снимок (snapshot) всех файлов из Changes на текущий момент. В Changes выбираем файлы для коммита и заполняем поле Commit message — коротко описываем, какие изменения сделаны в этом коммите:

Если изменить файл, который уже был закоммичен, он снова попадёт в Changes, но подсветится синим: для git это уже не новый файл, а изменённый.

Чтобы просмотреть все коммиты, перейдите на вкладку Log. Там видно, кто и когда сделал коммит, какие файлы изменились и с каким сообщением:

Шаг 4. Публикация проекта на GitHub

Пока всё происходило на вашем компьютере. Чтобы выложить проект в сеть, в верхнем меню выбираем Git → GitHub → Share Project on GitHub (в версиях до 2020.1 — VCS → Import into Version Control → Share Project on GitHub):

Откроется окно, где нужно указать имя репозитория и его видимость (публичный или приватный). После подтверждения IntelliJ IDEA создаст репозиторий на GitHub, привяжет его как origin и выполнит первый push. Ветка по умолчанию на GitHub с октября 2020 года называется main, а не master — это имя и будет в адресной строке репозитория.

Перед публикацией убедитесь, что аккаунт GitHub подключён к IDE: Подключение аккаунта GitHub к IntelliJ IDEA

Шаги 5 и 6. Операции push и pull

Push отправляет локальные коммиты в удалённый репозиторий на GitHub. Вызывается через Git → Push… (или Ctrl+Shift+K); в версиях до 2020.1 этот пункт назывался VCS → Git → Push. В окне видно список коммитов, которые уйдут на сервер:

Pull делает обратное: забирает с GitHub коммиты, которых нет у вас локально. Нужен, когда вы работаете с двух компьютеров или в команде. Вызывается через Git → Pull… (в версиях до 2020.1 — VCS → Git → Pull):

Если проект уже лежит на GitHub и его нужно наоборот скачать себе, посмотрите урок Клонирование проекта с GitHub в IntelliJ IDEA.

Те же шаги в терминале

Кнопки IDE выполняют обычные команды git. Полезно знать их: в терминале понятнее, что именно произошло, и это единственный вариант на сервере без графического интерфейса. Тот же сценарий с нуля до GitHub выглядит так:

git init                       # создать локальный репозиторий (.git)
git add Main.java              # добавить файл под контроль версий
git add .                      # или всё, что не попало в .gitignore
git commit -m "Initial commit" # сделать снимок состояния проекта
git remote add origin https://github.com/username/my-project.git
git branch -M main             # переименовать ветку в main
git push -u origin main        # первый push: связать локальную ветку с удалённой
git pull                       # забрать изменения с GitHub

Встроенный терминал IntelliJ IDEA открывается по Alt+F12 и работает в каталоге проекта, так что команды можно выполнять прямо оттуда.

На чём чаще всего спотыкаются

• Коммитят папку .idea и *.iml. Это настройки вашей IDE, а не код проекта: у коллег они вызывают постоянные конфликты. Место таким файлам — в .gitignore.
• Коммитят target, out, build и .class. Скомпилированные файлы получаются из исходников за секунды, но раздувают репозиторий и историю.
• Считают, что коммит попал на GitHub. Коммит — локальная операция. Пока не выполнен push, изменения существуют только на вашем компьютере.
• Пишут сообщения вида «fix», «123», «update». Через месяц по такому логу невозможно понять, что менялось; формулируйте, что сделано: «Add validation to User form».
• Заливают в публичный репозиторий пароли и ключи. Токены, пароли от БД, application.properties с реальными данными — удалить их из истории потом гораздо сложнее, чем не коммитить сразу.