使用git mv重命名子模块文件夹未达预期，如何正确操作？

问题原因 #

你执行git mv old-path new-path时，Git会将包含子模块的整个old-path目录作为整体移动到new-path下，导致子模块最终位于new-path/old-path，而非直接在new-path中。

操作步骤（适合Git新手的简单流程） #

• 手动移动子模块目录到目标路径：

  mv old-path new-path
  

  Windows系统替换为：

  move old-path new-path
  

• 编辑项目根目录下的.gitmodules文件，找到对应子模块的配置项，将path = old-path修改为path = new-path

• 让Git识别路径变更：

  git add .gitmodules new-path
  

• 提交本次更改：

  git commit -m "Move submodule from old-path to new-path"
  

验证操作 #

提交完成后，执行git submodule status，输出的子模块路径应为new-path，确认操作生效。

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