Adding a submodule in Git - Practice Problems & Coding Challenges

Challenge - 5 Problems

💻 Command Output

intermediate

What is the output of adding a submodule?

You run the command git submodule add https://github.com/example/lib.git libs/lib in your repository. What will be the immediate effect?

A A new folder <code>libs/lib</code> is created with the submodule content, and <code>.gitmodules</code> file is updated.

B The submodule is cloned but no changes are made to <code>.gitmodules</code>.

C The command fails because the submodule URL is not valid.

D The submodule is added but the main repository's <code>HEAD</code> is detached.

💡 Hint

Think about what files git updates when adding a submodule.

Adding a submodule clones the external repo into the specified folder and updates the .gitmodules file to track it.

🧠 Conceptual

intermediate

What does the .gitmodules file contain?

After adding a submodule, what is the purpose of the .gitmodules file in your repository?

A It stores the URL and path of each submodule to track them in the main repo.

B It contains the commit hashes of the submodule's latest commits.

C It lists all branches available in the submodule repository.

D It stores user credentials for accessing the submodule.

💡 Hint

Think about what information git needs to find the submodule source.

The .gitmodules file records the URL and local path of each submodule so git knows where to fetch it from.

❓ Troubleshoot

advanced

Why does 'git submodule update' fail after cloning?

You cloned a repository with submodules but running git submodule update --init gives an error: fatal: no submodule mapping found in .gitmodules for path 'libs/lib'. What is the likely cause?

A You forgot to run <code>git clone --recursive</code> initially.

B The submodule URL is unreachable due to network issues.

C The <code>.gitmodules</code> file is missing or corrupted in the cloned repo.

D The submodule folder was manually deleted after cloning.

💡 Hint

The error mentions missing mapping in .gitmodules.

The error means git cannot find the submodule configuration because the .gitmodules file is missing or does not list the submodule path.

🔀 Workflow

advanced

Correct sequence to add and commit a submodule

What is the correct order of commands to add a submodule and commit it to your repository?

A 2,1,3,4

B 1,3,2,4

C 1,2,3,4

D 3,1,2,4

💡 Hint

Remember you must add files before committing.

First add the submodule, then stage the .gitmodules and submodule folder, commit, and finally push.

✅ Best Practice

expert

Best practice for updating submodules in a team

Your team uses git submodules. What is the best practice to ensure everyone has the latest submodule changes after pulling the main repository?

A Only run <code>git pull</code> since submodules update automatically.

B Run <code>git clone</code> again to get the latest submodules.

C Delete the submodule folder and re-add it with <code>git submodule add</code> after pulling.

D Run <code>git pull</code> then <code>git submodule update --init --recursive</code> to sync submodules.

💡 Hint

Submodules require explicit update commands after pulling.

After pulling, running git submodule update --init --recursive ensures submodules are checked out to the correct commits.