Git submodule : inclure un dépôt dans un autre
git submodule te permet d'inclure un dépôt Git dans un autre. Idéal pour partager du code entre projets ou intégrer des librairies externes.
Par Anaïs Sparesotto, développeuse web et responsable pédagogique · Mis à jour le
C'est quoi git submodule ?
git submodule permet d'intégrer un dépôt Git dans un autre comme une dépendance versionnée. Le projet parent pointe vers un commit précis du submodule.
C'est comme avoir un livre dans un livre : le projet parent contient une référence au submodule, mais chacun a son propre historique et ses propres commits.
Syntaxe de git submodule
git submodule add url cheminAjouter un submodule
git submodule update --initInitialiser et télécharger
git submodule update --remoteMettre à jour vers le dernier commit
Git submodule en pratique
Ajouter, cloner et mettre à jour des submodules.
Ajouter un submodule
Cloner et mettre à jour
Commandes submodule essentielles
git submodule add urlAjouter un nouveau submodule
git submodule update --initInitialiser après un clone
git submodule update --remoteMettre à jour vers le dernier commit
git submodule statusVoir l'état des submodules
git submodule foreach cmdExécuter une commande dans chaque submodule
git submodule deinit cheminDeinitialiser un submodule
Erreurs courantes avec git submodule
Dossier vide après un clone
Les submodules ne sont pas téléchargés par défaut. Utilise git clone --recurse-submodules ou git submodule update --init après le clone.
Oublier de commiter la mise à jour
Après un git submodule update --remote, la nouvelle référence doit être commitée dans le projet parent. Sinon, les autres développeurs ne verront pas la mise à jour.
Difficulté à supprimer un submodule
La suppression nécessite plusieurs étapes. Pense à deinit, rm, et nettoyer .gitmodules. C'est une des opérations les plus confuses de Git.
Fait partie du guide Git avancé
GitQuest est conçu par Anaïs (nouvelle fenêtre), développeuse web et responsable pédagogique, spécialisée en formations tech et accessibilité numérique.
Questions sur git submodule
Maîtrise les projets complexes avec GitQuest
Apprends à gérer les submodules et les projets multi-dépôts.