手动修改.gitmodules无效？如何解决子模块同步异常问题

一、清理旧子模块moduleOld的残留 #

手动编辑.gitmodules删除子模块后，Git本地配置和缓存仍会残留相关记录，需彻底清理：

1. 移除.git/config中的旧子模块配置：

   git config --remove-section submodule.moduleOld
   

2. 删除.git/modules目录下的旧子模块文件夹：

   rm -rf .git/modules/moduleOld
   

3. 清除工作区中旧子模块的缓存记录：

   git rm --cached moduleOld
   

   （若提示路径不存在，直接跳过此步骤）

二、让新添加的子模块被Git识别并克隆 #

手动写入.gitmodules的子模块未被Git索引注册，需完成以下操作：

1. 将更新后的.gitmodules文件添加到Git索引：

   git add .gitmodules
   

2. 初始化并克隆新子模块：
   可指定新子模块路径单独处理：

   git submodule update --init --recursive <新子模块路径>
   

   也可执行全量更新（此时旧残留已清理，不会再触发报错）：

   git submodule update --init --recursive
   

验证操作结果 #

• 执行git submodule命令，应不再出现moduleOld的报错，能正常显示所有配置的子模块（含新添加的）
• 执行git submodule sync，应能列出所有已配置的子模块

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