如何移除中间Git子模块，将叶子子模块转为根仓库直接子模块并保留目录结构

要实现把leaf从middle的子模块转为root的直接子模块，同时保留root/middle/leaf目录结构，核心是彻底清除Git对middle作为子模块的所有追踪信息——你之前的报错就是因为Git仍残留着middle的子模块标记。以下是分步操作：

步骤1：彻底移除middle子模块的Git追踪 #

在root仓库根目录执行：

# 从Git索引中移除middle子模块标记（本地文件保留）
git rm --cached middle

# 删除.gitmodules中关于middle的条目（如果仓库还有其他子模块，不要直接删除整个文件）
# 若只有middle一个子模块，可直接删除文件：rm .gitmodules

# 删除Git存储的middle子模块元数据（关键步骤，之前操作遗漏了这个）
rm -rf .git/modules/middle

# 提交移除子模块的修改
git commit -m "彻底移除middle子模块追踪"

步骤2：清理middle目录内的leaf子模块痕迹 #

此时middle目录已不再是子模块，需要清理其中原leaf子模块的残留：

cd middle
# 移除leaf的子模块索引标记
git rm --cached leaf
# 删除middle目录下的.gitmodules（如果存在）
rm -f .gitmodules
cd ..

# 提交middle目录的清理修改
git add middle
git commit -m "清理middle目录内的子模块痕迹"

步骤3：将leaf添加为root的直接子模块到指定路径 #

现在可以正常添加leaf到middle/leaf路径：

# 先删除原middle/leaf目录（避免冲突）
rm -rf middle/leaf

# 添加leaf作为root的直接子模块
git submodule add <你的leaf仓库URL> middle/leaf

# 提交最终修改
git commit -m "将leaf添加为root的直接子模块，保留middle/leaf目录结构"

错误原因说明 #

之前操作失败是因为只清理了表面的.gitmodules和索引缓存，但Git在.git/modules目录中还保留着middle子模块的完整元数据，导致Git仍然认定middle是子模块，因此不允许在其路径下创建新的子模块。

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