Git未检测到特定文件删除问题求助及原因分析

核心原因 #

你遇到的异常是squash merge扁平化提交历史导致的Git文件追踪盲区，具体逻辑如下：

• 你的feature-branch通过提交27091955创建了PositionType.php。
• develop分支中该文件被删除，但删除操作被打包进了一个squash merge提交——squash merge会把多个提交的变更压缩成单个提交，丢失了单独的文件删除提交记录。
• 当你把origin/develop合并到feature-branch时，如果是fast-forward合并（即feature-branch在创建文件后没有新增独立提交），feature-branch的HEAD会直接指向develop的squash提交。此时：
  • 当前HEAD的树结构里已经没有该文件（git ls-tree -r HEAD无输出可证实），所以git status显示工作树干净（工作树与HEAD状态完全一致）。
  • 常规的git log --follow -- <file>命令默认只追踪直接修改该文件的非合并提交，不会展示合并/ squash提交中的文件删除操作，因此你看不到任何删除记录。

验证方法 #

要确认删除操作的存在，可执行以下命令：

# 查看HEAD提交中该文件的变更
git show HEAD -- app/Enums/CostEstimate/PositionType.php

如果文件确实是在HEAD提交中被删除，会输出类似deleted: app/Enums/CostEstimate/PositionType.php的内容。

另外，加上-m参数让Git展示合并提交中的文件变更：

git log --summary --follow -m -- app/Enums/CostEstimate/PositionType.php

这应该能捕捉到包含删除操作的squash提交。

规避方案 #

1. 公共分支禁用squash merge：squash merge会丢失提交细节，对于需要追踪文件全生命周期的场景，优先使用普通merge或rebase。
2. 合并后校验文件状态：将其他分支合并到功能分支后，用git diff --name-status <合并前提交ID> HEAD检查所有文件变更，确保关键文件状态符合预期。
3. 追踪文件时加-m参数：需要查看文件完整变更历史时，给git log加上-m参数，强制展示合并提交中的文件操作记录。

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