如何同步本地仓库并清除远程不存在的本地子模块？

以下是完善后的完整步骤，可彻底让本地仓库（包括子模块）与远程最新提交完全同步，同时移除本地存在但远程已删除的子模块：

• 进入主仓库目录：

  cd <main repo>
  

• 拉取远程主仓库最新提交，将本地主分支重置为远程状态：

  git fetch origin
  git reset --hard origin/<你的分支名>  # 替换为实际分支，如origin/main或origin/master
  

• 清理主仓库内的未跟踪文件及目录（不会影响子模块）：

  git clean -fxd
  

• 重置所有子模块的本地修改，并清理子模块内的未跟踪文件：

  git submodule foreach git reset --hard
  git submodule foreach git clean -fxd
  

• 移除本地多余的子模块（核心步骤，解决你遇到的问题）：
  可选择自动批量清理或手动逐个处理：

  1. 自动批量清理：

     git submodule foreach '
       if ! grep -q "$name" "$toplevel/.gitmodules"; then
         echo "移除无用子模块：$name（路径：$path）"
         git submodule deinit -f $path
         rm -rf $path
         git rm -f $path
       fi
     '
     

  2. 手动清理（若自动命令异常）：
     对每个远程已删除的子模块，依次执行：

     git submodule deinit -f <子模块路径>
     rm -rf <子模块路径>
     git rm -f <子模块路径>
     

• 初始化并同步所有远程存在的子模块：

  git submodule update --init --recursive
  

关键说明： #

• git submodule deinit 会移除本地Git配置中对子模块的注册；git rm 清理本地残留的子模块索引；rm -rf 删除本地磁盘上的子模块文件。
• 执行前请确认当前分支与目标远程分支对应，避免误操作。

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