Utilisation des branches de sous-modules
Apprenez à gérer et à changer de branche au sein d’un sous-module, puis à renvoyer les modifications vers son dépôt d’origine.
Utilisation des branches de sous-modules est une leçon Git Advanced: Monorepo, Submodules & Workflows gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Git Advanced: Monorepo, Submodules & Workflows, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Git Advanced: Monorepo, Submodules & Workflows comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
Branching in Submodules
Git submodules usually point to a specific commit. But what if you need to actively develop inside a submodule?
- This allows independent feature development.
- You can contribute changes back to the submodule's own project.
- It's key for complex projects needing tight integration.
Submodules: Detached HEAD
By default, when you clone a project with submodules, each submodule is checked out to a specific commit. This is called a "detached HEAD" state.
- It means you're not currently on any named branch.
- You can view files, but new commits won't automatically belong to a branch.
- It provides a stable way for the parent repo to reference specific submodule versions.
Navigating into a Submodule
To work with a submodule's branches, you first need to navigate into its directory. Think of it as entering a completely separate Git repository.
Use the cd command to change directories:
# Assume 'my-submodule' is a submodule
cd my-submodule
git statusChecking Submodule Status
Once inside the submodule's directory, you can use regular Git commands to see its status, branches, and current HEAD. This helps you understand its current state.
# Inside the submodule directory
git status
git branch
git log --oneline -1Switching Submodule Branches
To develop within a submodule, you need to switch from a detached HEAD to a specific branch. Use git checkout just like in any other Git repository.
# Inside the submodule directory
git checkout main
# Or to create and switch to a new branch
git checkout -b new-featureCommitting in a Submodule
Now that you're on a branch, you can make changes, add them, and commit them. These commits are specific to the submodule's repository, not the parent repository.
# Inside the submodule directory
echo "New content" > newfile.txt
git add newfile.txt
git commit -m "Added newfile in submodule"Pushing Submodule Changes
After committing changes within the submodule, you need to push them to the submodule's own remote repository. This makes your changes available to others.
# Inside the submodule directory
git push origin main
# Or to push a new branch
git push origin new-featureUpdating the Parent Repository
After pushing changes in the submodule, the parent repository still points to the old commit. You need to tell the parent repo to track the new commit.
- Navigate back to the parent repository.
- Stage and commit the submodule's change.
# Back in the parent repository
cd .. # Go up one level
git status
git add my-submodule
git commit -m "Updated my-submodule to latest commit"
git push origin mainSubmodule Branching Tips
Working with submodule branches requires care and coordination:
- Communicate: Inform your team if you're actively developing on a submodule branch.
- Keep parent updated: Always commit the submodule reference change in the parent repo after pushing submodule changes.
- Avoid direct pushes: Don't push to a submodule's
mainbranch from the parent repo unless absolutely necessary; work inside the submodule itself.
Submodule Branch Quiz
Test your knowledge on managing submodule branches!
Recap: Submodule Branches
In this lesson, we explored how to actively develop within a Git submodule:
- Navigating into the submodule's directory.
- Switching from a detached HEAD to a specific branch.
- Making, committing, and pushing changes in the submodule.
- Updating the parent repository's reference to the new submodule commit.
This workflow enables independent development and contribution to submodule projects, making your overall project more flexible.
Questions Fréquemment Posées
La leçon « Utilisation des branches de sous-modules » est-elle gratuite ?
Oui — le texte complet de « Utilisation des branches de sous-modules » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Git Advanced: Monorepo, Submodules & Workflows, passe à CoddyKit PRO. Le cours Git Advanced: Monorepo, Submodules & Workflows comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Utilisation des branches de sous-modules » ?
Apprenez à gérer et à changer de branche au sein d’un sous-module, puis à renvoyer les modifications vers son dépôt d’origine. Tu pratiques Git Advanced: Monorepo, Submodules & Workflows avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Git Advanced: Monorepo, Submodules & Workflows ?
Aucune expérience préalable n'est requise. Git Advanced: Monorepo, Submodules & Workflows sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.
Combien de temps prend la leçon « Utilisation des branches de sous-modules » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Git Advanced: Monorepo, Submodules & Workflows ?
Oui. Chaque leçon Git Advanced: Monorepo, Submodules & Workflows inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Utilisation des branches de sous-modules
- Sous-modules imbriqués et configurations complexes
- Problèmes courants des sous-modules et correctifs
- Figer des sous-modules sur des balises et des commits précis