Die Frustrationsliste

Submodule sind machtig, bringen aber neue Nutzer wiederholt zu Fall. Diese Seite katalogisiert die haufigsten Fehler.

Leeres Submodul-Verzeichnis

git submodule update --init --recursive

Detached-HEAD-Anderungen verloren

cd third_party/lib
git reflog
git checkout -b rescue HEAD@{1}

URL upstream geandert

git submodule sync --recursive
git submodule update --init --recursive

Submodul entfernen

git submodule deinit -f third_party/lib
git rm -f third_party/lib
rm -rf .git/modules/third_party/lib
git commit -m "Remove lib submodule"

Inhalt geandert aber kein Diff

git submodule update --recursive
git add third_party/lib && git commit -m "Bump lib"

Push-Reihenfolge zahlt

git config --global push.recurseSubmodules on-demand

Shallow-Submodule

git submodule update --init --recursive --depth 1

Haufige Fehler

Submodule wie normale Unterverzeichnisse behandeln — sie sind es nicht.