Windows下git checkout切换分支时残留其他分支文件的问题

可能原因 #

1. 3D-CAD-design分支已意外纳入ESP32 code文件夹：可能是之前的合并操作、误提交导致该文件夹被加入到分支的版本控制中，和你记忆中的分支初始状态不符。
2. 未跟踪文件残留：尽管你确认所有内容已提交，但切换分支时可能存在未被Git跟踪的ESP32 code文件夹残留，Git默认不会自动删除未跟踪内容。

解决步骤 #

第一步：确认分支实际内容

切换到3D-CAD-design分支，执行以下命令查看该分支最新提交的所有文件/文件夹：

git ls-tree -r HEAD --name-only

如果输出中包含ESP32 code（或其下的文件路径），说明该分支确实已将此文件夹纳入版本控制，需要手动删除并提交修改。

情况1：分支已包含该文件夹

执行以下命令删除文件夹并提交修改：

git rm -r "ESP32 code"
git commit -m "Remove ESP32 code folder from 3D-CAD-design branch"
git push origin 3D-CAD-design

完成后再次切换分支，3D-CAD-design分支就不会再显示ESP32 code文件夹。

情况2：分支未包含该文件夹（未跟踪残留）

如果git ls-tree输出里没有ESP32 code相关内容，说明这是未跟踪的残留文件，执行以下命令清理所有未被Git跟踪的文件和文件夹：

git clean -fd

注意：git clean -fd会彻底删除所有未被Git跟踪的内容，执行前请确认这些文件无需保留。

额外检查

可以查看3D-CAD-design分支的提交历史，定位ESP32 code文件夹被加入的时间节点：

git log --oneline -- "ESP32 code"

这能帮你找到误操作的来源，避免后续重复出现类似问题。

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