Skip to content
  • Home
  • About
  • No Access
  • Privacy Policy
Bits of .NET
Bits of .NET
  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy

Bits of .NET

Daily micro-tips for C#, SQL, performance, and scalable backend engineering.

  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy
Git

Git: Fix a Submodule Stuck on a Detached Head After a Pull

- 16.11.26 - ErcanOPAK

🔀 Git: Fix a Submodule Stuck on a Detached Head After a Pull

Running git pull on a superproject updates the recorded submodule commit pointer in the index, but unless submodule.recurse is configured, it doesn’t check out that commit inside the submodule’s own working tree – and even when it does, the submodule lands at a detached HEAD pointing at that commit, not on any branch. A teammate who opens the submodule folder from that state, commits a quick fix, and later pulls again from inside it can find that commit stranded on no branch at all, invisible to git log --all and reachable only through the reflog.

🔎 The Problem

$ cd my-submodule && git status
HEAD detached at 8f21a90
$ git commit -am "quick fix"
[detached HEAD a93f102] quick fix
$ git pull
Already up to date.      # pulled nothing useful; commit a93f102 is
                          # still only reachable from the reflog,
                          # not from any branch

✅ Fix: Check for a Detached Head Before You Commit Inside a Submodule

  • Before making any change inside a submodule, run git status there first and check for “HEAD detached at” – if you see it, create or check out a real branch before committing anything, rather than committing straight onto the detached state.
  • Set submodule.recurse=true at the superproject level so routine pull and checkout operations keep submodules in sync automatically, which reduces how often you land on a fresh detached HEAD without realizing a pull just moved it.
  • If a commit is already stranded, find it with git -C <submodule> reflog and cherry-pick or branch it from there – it isn’t actually gone, just unreachable from any ref.

🚨 Why This Is Dangerous

  • A commit made on a detached HEAD inside a submodule can survive for weeks only in the reflog, which has its own expiry – assuming “it’s committed, so it’s safe” skips the part where detached commits are one git gc away from being genuinely unrecoverable.

A submodule pull moves where HEAD points – it never promises HEAD is pointing at a branch. Check before you commit, not after.

— Version Control Tip

Related posts:

Git: Fix a Confusing Diff That Shows an Entire Function as Changed Because the Default Diff Algorith...

Git: Fix a Confusing Diff That Shows an Entire Function as Changed Because the Default Diff Algorith...

Git: Fix a Detached HEAD Before You Lose Your Last Hour of Commits

Git: Fix a Detached HEAD Before You Lose Your Last Hour of Commits

Git Hooks Automation: Pre-commit Checks That Save Hours of Debugging

Git Hooks Automation: Pre-commit Checks That Save Hours of Debugging

Views: 3

Post navigation

CSS: Fix a Grid Item Overflowing Its Track From Implicit Min-Width
Asp.Net Core: Fix Antiforgery Tokens Rejected Behind a Reverse Proxy

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

November 2026
M T W T F S S
 1
2345678
9101112131415
16171819202122
23242526272829
30  
« Oct    

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,055)
  • Get the User Name and Domain Name from an Email Address in SQL (980)
  • How to add default value for Entity Framework migrations for DateTime and Bool (976)
  • Get the First and Last Word from a String or Sentence in SQL (857)
  • How to select distinct rows in a datatable in C# (852)
  • How to enable, disable and check if Service Broker is enabled on a database in SQL Server (653)
  • Add Constraint to SQL Table to ensure email contains @ (607)
  • Average of all values in a column that are not zero in SQL (569)
  • How to use Map Mode for Vertical Scroll Mode in Visual Studio (546)
  • Find numbers with more than two decimal places in SQL (475)

Recent Posts

  • C#: Fix a ConditionalWeakTable Entry Vanishing Too Soon
  • Docker: Fix a Stale COPY Layer After Editing .dockerignore
  • Photoshop: Fix a Pattern Overlay Scaling Wrong on a High-DPI File
  • SQL Server: Fix a Computed Column Index Skipped by Implicit Cast
  • HTML5: Fix a required Input Inside a Hidden Tab Blocking Submit
  • SQL Server: Fix ROW_NUMBER Ties Reordering Between Identical Runs
  • C#: Fix an Enum HasFlag Returning True for the Zero Value
  • WordPress: Fix Featured Images Vanishing After a CDN Migration
  • Photoshop: Fix Content-Aware Fill Smearing a Repeating Pattern
  • Asp.Net Core: Fix Antiforgery Tokens Rejected Behind a Reverse Proxy

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,055)
  • Get the User Name and Domain Name from an Email Address in SQL (980)
  • How to add default value for Entity Framework migrations for DateTime and Bool (976)
  • Get the First and Last Word from a String or Sentence in SQL (857)
  • How to select distinct rows in a datatable in C# (852)

Recent Posts

  • C#: Fix a ConditionalWeakTable Entry Vanishing Too Soon
  • Docker: Fix a Stale COPY Layer After Editing .dockerignore
  • Photoshop: Fix a Pattern Overlay Scaling Wrong on a High-DPI File
  • SQL Server: Fix a Computed Column Index Skipped by Implicit Cast
  • HTML5: Fix a required Input Inside a Hidden Tab Blocking Submit

Social

  • ErcanOPAK.com
  • GoodReads
  • LetterBoxD
  • Linkedin
  • The Blog
  • Twitter
© 2026 Bits of .NET | Built with Xblog Plus free WordPress theme by wpthemespace.com