Aller au contenu principal
Télécharger

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.

GitQuest
Démo

Par Anaïs Sparesotto, développeuse web et responsable pédagogique · Mis à jour le

Avancé

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 chemin

Ajouter un submodule

git submodule update --init

Initialiser et télécharger

git submodule update --remote

Mettre à 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 url

Ajouter un nouveau submodule

git submodule update --init

Initialiser après un clone

git submodule update --remote

Mettre à jour vers le dernier commit

git submodule status

Voir l'état des submodules

git submodule foreach cmd

Exécuter une commande dans chaque submodule

git submodule deinit chemin

Deinitialiser 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é

A

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.