自动化Qt构建遇子模块问题：无法获取干净工作目录

跨Qt版本切换时遇到子模块清理不干净的问题太常见了——毕竟不同版本的子模块结构可能有差异（比如你从v5.9.0切到v5.8.0，v5.9新增的qtremoteobjects在v5.8里根本不存在，自然会留下未跟踪目录）。标准的清理命令有时候会因为子模块有本地修改或者嵌套层级的问题跳过内容，试试下面这套完整的清理流程：

第一步：强制重置所有子模块到纯净状态 #

先把所有子模块的本地修改全部丢弃，确保子模块回到对应版本的HEAD状态：

git submodule foreach --recursive "git reset --hard HEAD"

第二步：彻底清理子模块和主仓库的未跟踪内容 #

接着清理所有未跟踪的文件、目录，包括.gitignore里忽略的内容：

git submodule foreach --recursive "git clean -dfx" && git clean -dfx

这里的-d会删除未跟踪的目录，-f强制清理，-x会连.gitignore中标记忽略的文件也一起删掉，确保不留任何残留。

第三步：重新同步子模块到当前版本 #

最后重新初始化并更新所有子模块，确保它们完全匹配当前主仓库v5.8.0版本的要求：

git submodule update --init --recursive

如果上面的方法还没解决问题，试试终极重置方案 #

要是残留问题依然存在，说明子模块的本地缓存可能有问题，可以彻底重置子模块的本地状态：

# 取消所有子模块的本地关联
git submodule deinit --all -f
# 删除子模块的本地缓存目录
rm -rf .git/modules
# 重新拉取并初始化所有子模块
git submodule update --init --recursive

这个操作相当于把所有子模块从头拉一遍，能解决绝大多数跨版本切换时的子模块残留问题。

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