Компьютеры · Инструкция
git submodule absorbgitdirs: когда нужен
git submodule absorbgitdirs: когда нужен — команда полезна, когда метаданные подмодуля ещё лежат внутри его рабочего каталога. Она переносит git-dir в $GIT_DIR/modules суперпроекта и оставляет в подмодуле файл .
Короткий ответ
`git submodule absorbgitdirs` переносит Git-каталог субмодуля внутрь `$GIT_DIR/modules` суперпроекта и оставляет в рабочем каталоге субмодуля файл `.git`, указывающий на новое место. Обычно это нужно для старых или вручную добавленных субмодулей с отдельным `.git`-каталогом.
Что именно меняет absorbgitdirs
В старой схеме субмодуль мог содержать полноценный каталог `.git` прямо внутри своей рабочей директории. Современный Git обычно хранит эти данные в `$GIT_DIR/modules/<path>` суперпроекта, а в субмодуле оставляет текстовый `.git`-файл с `gitdir:`. `absorbgitdirs` переносит существующий Git-каталог в это центральное место, настраивает `core.worktree` и создаёт ссылку обратно. История и рабочие файлы не должны переписываться только из-за этой миграции.
Совет: Сделайте резервную ветку или commit перед изменением служебной структуры, если репозиторий важен.
Как безопасно выполнить миграцию
- Зафиксируйте или временно сохраните незакоммиченные изменения в суперпроекте и субмодуле.
- Проверьте `git status` в субмодуле и убедитесь, что понимаете, где сейчас находится его `.git`.
- Из корня суперпроекта выполните `git submodule absorbgitdirs` либо укажите конкретный путь субмодуля.
- После команды проверьте, что внутри субмодуля `.git` стал файлом-ссылкой, а данные появились под `.git/modules`.
- Запустите `git status` и `git submodule status`, затем обычный fetch/checkout, чтобы подтвердить работоспособность.
Когда команду не нужно запускать «для профилактики»
Если субмодуль уже использует современный layout, полезного изменения может не быть. Команда также не исправляет неверный URL, detached HEAD, отсутствующий commit или конфликт в `.gitmodules` — это другие проблемы. Особенно осторожно работайте со скриптами, которые напрямую предполагают наличие каталога `submodule/.git`: после миграции там будет файл. Такие скрипты нужно исправить, а не откатывать структуру.
Предупреждение: Не путайте `absorbgitdirs` с `sync`, `update` или `deinit`: они решают другие задачи.
После команды проверьте
- `.git` в субмодуле является файлом с gitdir;
- `git status` работает внутри субмодуля;
- `git submodule status` показывает ожидаемый commit;
- CI/скрипты не завязаны на каталог `submodule/.git`.
Что меняется после команды
После absorbgitdirs рабочее дерево подмодуля остаётся на месте: переносится его служебный Git-каталог, а файл .git начинает указывать на новое расположение. Поэтому операция полезна для унификации структуры, но не заменяет commit, sync или update самого подмодуля.
Когда absorbgitdirs особенно полезна
Команда удобна после старых способов добавления submodule или после ручного переноса репозитория, когда служебный каталог Git ещё лежит внутри рабочего дерева подмодуля. Перенос в `$GIT_DIR/modules` делает структуру ближе к современной схеме Git. Перед массовым запуском в монорепозитории проверьте один подмодуль и убедитесь, что относительные пути и рабочее дерево продолжают определяться правильно.
Пример старого вручную вложенного репозитория
Вы когда-то клонировали зависимость отдельно, затем добавили её как submodule, и в каталоге зависимости остался полноценный `.git`. `absorbgitdirs` как раз предназначен для такой структуры: он переносит служебный каталог под суперпроект. Это удобнее для удаления рабочей директории субмодуля без потери его локальных Git-данных и соответствует современному устройству submodule.
Важно: Не удаляйте `.git/modules` после миграции — там теперь находятся реальные Git-данные субмодуля.
Что учитывать
Условия меняются. Страница отражает состояние на 2026-09-23; при расхождении с официальной документацией приоритет у первоисточника.
Источники и проверка
Инструкция составлена редакцией N1RO на 2026-09-23. Перед действием сверьте актуальные условия на официальном сайте сервиса или производителя.