Git提交单文件变更后意外删未触碰目录的原因及规避方法

嘿，这个问题我碰到过类似的情况，咱们先拆解可能的原因，再给你靠谱的规避方法：

我先列几个实际排查中最常见的原因：

• 提交时误包含了未察觉的删除操作：你可能之前手动删除了那些目录，但没留意，然后用了git commit -a或者git add .这类批量命令，把这些删除操作和单文件修改一起提交了。有时候git show的默认diff会因为显示设置截断内容，你可以用git show --stat 3dc0de9看完整的变更文件列表，就能确认是不是这种情况。
• 稀疏检出（Sparse Checkout）搞的鬼：如果你的仓库开启了稀疏检出模式，只指定了部分目录被检出，当你提交变更时，Git会把不在检出列表里的已追踪目录标记为“已删除”，哪怕你没手动删。而git cherry-pick只处理单个文件，不会触发这种目录删除的逻辑。
• .gitignore规则变动的遗留问题：如果在这个提交之前，你修改了.gitignore把那些目录加进去了，但这些目录之前已经被Git追踪了。Git不会自动忽略已追踪的文件，但某些情况下（比如用了git add --all），可能会误将这些文件标记为删除提交。

按这个顺序查，很快就能定位问题：

1. 查看提交的完整变更：执行git show --stat 3dc0de9，这个命令会列出该提交所有变更的文件（包括删除的），一眼就能确认是不是提交时带了意外删除。
2. 检查稀疏检出状态：跑git config core.sparseCheckout，如果返回true，就打开.git/info/sparse-checkout看看规则是不是把那些被删的目录排除了。
3. 回顾提交命令：看看你提交时用的是git commit <单个文件>还是批量提交命令，git commit -a这类操作很容易带上未留意的变更。

这些方法能从根源帮你避免这类问题：

• 提交前必查暂存区：每次提交前一定要执行git diff --cached，这个命令会显示所有将要提交的变更（修改、新增、删除全包含），确认没问题再提交。
• 精准提交，拒绝批量操作：只改了单个文件的话，就用git add 你的文件名+git commit，别用git add .或者git commit -a，除非你明确知道所有变更都需要提交。
• 稀疏检出场景下要格外注意：开启稀疏检出后，每次提交前用git status检查有没有意外的“deleted”标记，及时调整检出规则。
• 提交后立刻验证：提交完马上跑git log --oneline --stat看一眼提交的变更，或者切换到其他分支再切回来，确认关键目录是否存在。

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