C'est quoi un submodule ?

Un submodule est un depot Git imbrique dans un autre depot. Le projet parent reference un commit precis du submodule. C'est utile pour inclure des librairies ou du code partage entre projets.

Pourquoi le dossier du submodule est vide apres un clone ?

Par defaut, git clone ne telecharge pas les submodules. Utilise --recurse-submodules lors du clone, ou fais git submodule update --init apres.

Comment mettre a jour un submodule ?

cd dans le dossier du submodule et fais git pull, ou depuis le parent : git submodule update --remote. N'oublie pas de commiter la reference mise a jour dans le projet parent.

Comment supprimer un submodule ?

C'est en plusieurs etapes : git submodule deinit chemin, git rm chemin, puis supprime la section dans .gitmodules et .git/modules. Enfin, commite les changements.

Quelle alternative aux submodules ?

Les gestionnaires de paquets (npm, pip) sont souvent plus simples pour les dependances. Git subtree est une alternative qui fusionne le code dans le depot parent. Les monorepos evitent le besoin de submodules.

Git submodule : inclure un depot dans un autre

git submodule te permet d'inclure un depot Git dans un autre. Ideal pour partager du code entre projets ou integrer des librairies externes.

Pratiquer git submodule Glossaire Git

gitquest — enquête

Avance

C'est quoi git submodule ?

git submodule permet d'integrer un depot Git dans un autre comme une dependance versionnee. Le projet parent pointe vers un commit precis du submodule.

C'est comme avoir un livre dans un livre : le projet parent contient une reference 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 telecharger

git submodule update --remote

Mettre a jour vers le dernier commit

Git submodule en pratique

Ajouter, cloner et mettre a jour des submodules.

Ajouter un submodule

gitquest — submodule add

# Ajouter un submodule a ton projet

$git submodule add https://github.com/lib/utils.git libs/utils

Clonage dans 'libs/utils'...

remote: Enumerating objects: 42, done.

$git status

nouveau fichier : .gitmodules

nouveau fichier : libs/utils

$git commit -m "feat: ajouter le submodule utils"

[main a1b2c3d] feat: ajouter le submodule utils

Cloner et mettre a jour

gitquest — submodule update

# Cloner un projet qui a des submodules

$git clone --recurse-submodules https://github.com/mon/projet.git

Submodule 'libs/utils' enregistre et clone

# Ou initialiser apres un clone classique

$git submodule update --init --recursive

Submodule path 'libs/utils': checked out 'c3d4e5f'

# Mettre a jour un submodule

$git submodule update --remote

Submodule path 'libs/utils': checked out 'e4f5g6h'

Commandes submodule essentielles

git submodule add url

Ajouter un nouveau submodule

git submodule update --init

Initialiser apres un clone

git submodule update --remote

Mettre a jour vers le dernier commit

git submodule status

Voir l'etat des submodules

git submodule foreach cmd

Executer une commande dans chaque submodule

git submodule deinit chemin

Deinitialiser un submodule

Erreurs courantes avec git submodule

Dossier vide apres un clone

Les submodules ne sont pas telecharges par defaut. Utilise git clone --recurse-submodules ou git submodule update --init apres le clone.

Oublier de commiter la mise a jour

Apres un git submodule update --remote, la nouvelle reference doit etre commitee dans le projet parent. Sinon, les autres developpeurs ne verront pas la mise a jour.

Difficulte a supprimer un submodule

La suppression necessite plusieurs etapes. Pense a deinit, rm, et nettoyer .gitmodules. C'est une des operations les plus confuses de Git.

Fait partie du guide Git avance

Commandes liées

git clone

Cloner avec --recurse-submodules

git remote

Gerer les depots distants

git config

Configurer les submodules

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

Maitrise les projets complexes avec GitQuest

Apprends a gerer les submodules et les projets multi-depots.

Commencer les enquetes