Git切换tag后未暂存变更无法清除的问题求助

步骤1：强制同步子模块到Tag指定版本 #

ESP-IDF的Tag会绑定特定版本的子模块，仅切换主仓库Tag后子模块可能未同步到对应版本，执行以下命令强制拉取Tag关联的子模块状态：

git submodule update --init --recursive --force

--force参数会覆盖子模块的本地修改，确保完全对齐当前Tag的子模块版本。

步骤2：递归清理所有未跟踪文件（含子模块） #

之前的清理命令可能未覆盖子模块内部的未跟踪内容，用以下命令彻底清除所有未跟踪文件与目录：

git submodule foreach --recursive git clean -d -f -x

-x参数会清理.gitignore中忽略的文件，确保没有残留的未跟踪内容。

步骤3：递归重置所有子模块到HEAD状态 #

如果子模块仍有未暂存变更，执行递归重置命令，将所有子模块强制恢复到当前主仓库Tag对应的提交：

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

步骤4：验证最终状态 #

完成上述操作后，执行以下命令确认工作区状态：

git status

正常情况下会显示工作区干净，子模块无变更。

极端情况处理 #

如果以上步骤仍无效，可能是本地仓库缓存异常，可尝试删除主仓库的子模块缓存目录后重新初始化：

rm -rf .git/modules
git submodule update --init --recursive --force

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