浅克隆仓库（深度1）获取最新提交变更文件列表的方法

一、解决思路 #

深度1的浅克隆里Git拿不到父提交信息，没法算出变更文件，给你两个实用方案：

1. 拉取深度为2的克隆 #

既然要对比当前提交和它的父提交，直接把克隆深度设为2就行，CI里这点额外开销完全可以忽略：

git clone --depth=2 <你的仓库地址>

之后用你原来的命令就能正常检测dir_a的变更：

git diff --name-only HEAD^ HEAD -- dir_a

2. 借助CI平台自带的变更信息 #

很多CI工具（比如GitHub Actions、GitLab CI）会在触发构建时直接提供本次提交的变更文件列表，根本不用自己用Git命令算。比如GitHub Actions里可以直接用github.event.head_commit.modified拿到所有变更文件的数组，接着判断里面有没有dir_a下的文件就行。这种方式完全不依赖Git历史，适合追求极致性能的场景。

二、这是浅克隆的特性，不是Bug #

Git浅克隆（--depth=N）的核心就是只拉取指定深度的历史提交。当深度设为1时，本地仓库只有最新的那一个提交快照，没有它的父提交数据。而git show能输出变更文件的前提是，必须有父提交的快照来做对比——没有父提交的话，Git根本不知道哪些文件是这次提交改的，只能把该提交里dir_a目录下的所有文件都列出来。

三、为什么同一SHA的git show输出不一样？ #

提交SHA是这个提交内容的唯一哈希，它只对应提交本身的快照、作者、提交信息这些数据，不包含父提交的信息。在完整克隆或者深度2的克隆里，本地有这个提交的父提交，Git能对比两个快照得出变更文件；但深度1的浅克隆里没有父提交数据，Git没法做对比，只能退而求其次展示该提交里指定目录的所有文件。所以输出差异不是提交本身变了，是本地能用到的历史数据不一样。

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