为何`git submodule update --remote --recursive`命令执行后未生效？

这不是Git默认实现的问题，而是对命令逻辑和子模块工作机制的误解，常见原因有以下几点：

1. --remote仅更新子模块内容，不会自动提交父仓库的子模块指针 #

git submodule update --remote的核心逻辑是：

• 拉取子模块配置中指定分支（PX4通常已预先配置）的最新远程提交
• 将子模块本地目录checkout到该最新提交

但这个命令不会自动更新父仓库中记录的子模块哈希值。父仓库原本存储的是子模块某个特定提交的哈希，当子模块被--remote切换到远程分支的新提交后，父仓库的子模块指针就和子模块当前HEAD不一致了，因此git status会显示子模块存在"新提交"（本质是父仓库需要更新子模块的引用）。

如果要让父仓库同步这个变化，需要在执行完update --remote后，手动在父仓库中提交子模块的引用修改：

git add <子模块路径>
git commit -m "Update submodules to remote latest"

2. 子模块本地存在未跟踪的构建产物 #

PX4构建过程中会在子模块目录生成临时文件、编译产物（比如build目录、二进制文件），这些文件通常不在子模块的.gitignore中，或者构建后残留。即使执行了--force --checkout，Git只会覆盖已跟踪文件的修改，不会删除未跟踪文件，因此git status会显示子模块有"未跟踪文件"的修改。

解决方法：

• 进入子模块目录清理未跟踪文件：

  cd <子模块路径>
  git clean -fd
  git reset --hard
  

• 或者在父仓库根目录批量清理所有子模块：

  git submodule foreach --recursive 'git clean -fd && git reset --hard'
  

3. 子模块的远程分支与父仓库记录的提交不一致 #

如果你切换到的PX4版本中，父仓库记录的子模块是某个固定提交哈希，但--remote会强制拉取子模块远程分支的最新提交，这就会导致子模块HEAD脱离父仓库指定的版本，自然会在git status中显示差异。

如果你需要严格按照父仓库当前版本的子模块提交来同步，应该去掉--remote参数，直接执行：

git submodule update --recursive --force --checkout

这个命令会完全按照父仓库记录的哈希，将所有子模块checkout到指定提交，不会拉取远程分支的最新内容。

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