Git Extensions克隆仓库后显示的子模块与Git命令行不一致

核心原因 #

这种差异大概率是子模块的本地路径与配置文件不匹配，或是Git Extensions的缓存/显示逻辑问题导致的：

• Git的子模块名称由根目录下的.gitmodules文件定义，而本地工作区的子模块文件夹名可以和配置中的名称不一致。Git命令行和远程仓库会优先遵循.gitmodules的配置信息，但Git Extensions这类GUI工具可能直接读取本地文件夹的实际名称，或是缓存了旧的子模块数据。
• 另一种可能是本地子模块文件夹曾被手动重命名，但.gitmodules和远程仓库的配置未同步修改，导致命令行与GUI工具的显示出现分歧。

排查与修复步骤 #

1. 核对.gitmodules配置
   打开仓库根目录的.gitmodules文件，找到对应子模块的配置段：

   [submodule "model_target/csar_lib"]
       path = model_target/csar_lib
       url = <子模块远程仓库地址>
   

   确认name和path字段均指向model_target/csar_lib，确保配置本身无问题。

2. 检查本地文件夹实际名称
   在命令行进入model_target目录，执行：

   ls -l
   

   查看实际文件夹名是csar_lib还是csar_utilities。如果是后者，说明本地文件夹被重命名过，这就是Git Extensions显示异常的原因。

3. 刷新Git Extensions缓存
   尝试通过以下操作更新工具状态：

   • 关闭并重新启动Git Extensions
   • 点击界面上的「刷新」按钮（通常是环形箭头图标）
   • 执行仓库的「Fetch」操作，同步远程最新配置

4. 重置子模块本地路径
   若本地文件夹名确实不符，执行以下命令重置子模块：

   git submodule deinit model_target/csar_lib
   git rm model_target/csar_lib
   git submodule update --init model_target/csar_lib
   

   这会按照.gitmodules的配置重新拉取子模块，恢复正确的文件夹名称。

5. 升级Git Extensions版本
   部分旧版本的Git Extensions存在子模块显示bug，优先展示本地文件夹名而非配置中定义的名称。升级到最新版本后，这类问题通常会被修复。

注：只要三者指向的commit ID一致，子模块的代码内容是完全一致的，只是显示名称的差异，不会影响代码功能。

内容的提问来源于stack exchange，提问作者tadm123