Как настроить и использовать подмодули Git submodules для управления зависимостями?

Подмодули в Git представляют собой механизм, который позволяет встроить один независимый репозиторий внутрь другого репозитория в качестве поддиректории. Это особенно полезно, когда ваш проект зависит от сторонней библиотеки или общего модуля, который развивается отдельно, но вы хотите иметь возможность фиксировать точную рабочую версию этой зависимости прямо в своем коде.

Для добавления нового подмодуля в проект используется команда git submodule add, за которой следует URL-адрес удаленного репозитория библиотеки и путь, по которому она должна располагаться в вашем проекте. После выполнения этой команды Git клонирует указанный репозиторий внутрь вашего проекта и создает специальный файл конфигурации .gitmodules, где хранятся метаданные о подключенных зависимостях.

Важно понимать, что при клонировании основного репозитория, который содержит подмодули, папки с подмодулями по умолчанию остаются пустыми. Чтобы скачать их содержимое, разработчику после клонирования необходимо выполнить инициализацию и обновление подмодулей с помощью команды git submodule update --init --recursive. Флаг recursive гарантирует, что будут загружены даже вложенные подмодули, если они есть.

Работа с кодом внутри подмодуля имеет свои особенности. Когда вы заходите в папку с подмодулем, вы попадаете в состояние отдельного независимого репозитория с собственным указателем HEAD. Если вы внесли изменения в код подмодуля и закоммитили их там, основной проект не подхватит эти изменения автоматически. В родительском репозитории просто обновится хэш коммита, на который ссылается подмодуль, и этот новый хэш нужно будет зафиксировать отдельным коммитом.

Для обновления всех подмодулей в проекте до актуальных версий из удаленных репозиториев используется команда git submodule update --remote. Это позволяет быстро подтягивать последние изменения внешних зависимостей. Удаление подмодуля требует ручного удаления записи из конфигурационного файла .gitmodules, очистки кэша Git и удаления самой папки с зависимостью с диска.