假设构建脚本先用 git diff --quiet 检查仓库,再决定要不要打包。你改了 app.txt,跑过 git add,旁边还留着一个新文件。脚本却拿到了退出码 0。这不是 Git 漏报:这条命令只比较工作树和暂存区。要防止打包脚本把「没查到」当成「没有」,先得把比较对象写清楚。
git add 移走的是哪一份差异拿一个普通的已跟踪文件举例:最近一次提交里写着 base,工作树改成了 edit。刚修改完时,暂存区仍是 base,所以 git diff --quiet 给 1,git diff --cached --quiet 给 0。
执行 git add 后,暂存区也变成 edit。工作树和暂存区相同,第一条就给 0;暂存区和 HEAD 仍然不同,第二条给 1。两条命令看的不是同一组内容。如果再把工作树改成 second edit 而不暂存,两条都会给 1。同一个文件可以同时有待提交和未暂存的变化。
--cached 未指定提交时通常以 HEAD 为基准。刚初始化还没有 HEAD 时,Git 会报告全部暂存变化;图里画的是已有首次提交的情形。git diff HEAD 也不宜代替两次独立比较:比如暂存区是 edit,工作树又被改回 base,工作树与 HEAD 的内容相同,中间那份待提交变化仍在。

图:已有 HEAD 时的三个检查面。前两栏是独立比较;普通未跟踪文件不在两条 diff 的比较范围内。
本文使用 AI 辅助写作及配图。
在提交前只问「还有哪处修改没暂存」,就用第一条;要看下一次普通提交准备带走什么,就看 git diff --cached。--quiet 隐藏差异输出并隐含 --exit-code:正常比较中 0 表示无差异,1 表示有差异,其他退出值不该塞进「有修改」这个分支。用 cmd || true 吞掉退出码后,路径传错和确实没有差异都会变成 0。
如果打包门禁要求「不能有已暂存、未暂存或普通未跟踪的变化」,可以用 git status --porcelain=v1 --untracked-files=all。这个命令成功列出变化时也可以退出 0;应先检查命令是否成功,再看输出是否为空。示例只判断空或非空,不解析文件名。要逐个处理路径时,按文档读 -z 的 NUL 分隔字节和重命名记录,别按空格拆,也别把 NUL 数据塞进 Bash 命令替换。
忽略文件另算。下面的 build.log 命中 .gitignore,所以状态可以是干净,文件仍实际存在。若产物会打包整个目录,最好核对打包器实际纳入的文件;单靠 Git 状态不会把被忽略的旧产物挡在包外。只想列普通未跟踪路径,也可以用 git ls-files --others --exclude-standard,但这条不回答已有跟踪文件改没改。
把完整代码保存成 git-diff-lab.sh,用 Bash 运行。实验只操作自己创建的临时目录,关闭系统 Git 配置、使用空 HOME 和模板,不读取现有项目,也不访问远端。三列依次是普通 diff、暂存 diff、示例自定义门禁。未跟踪测试特意用了含空格的文件名,用来对照只判断输出有无的做法。
#!/usr/bin/env bash
set -eu
# 只创建临时仓库,不继承调用者的 Git 环境配置。
lab=$(mktemp -d)
trap 'rm -rf -- "$lab"' EXIT
mkdir "$lab/repo" "$lab/outside" "$lab/home" "$lab/template"
g() {
env -i PATH="$PATH" LC_ALL=C HOME="$lab/home" \
GIT_CONFIG_NOSYSTEM=1 GIT_CEILING_DIRECTORIES="$lab" git "$@"
}
repo=$lab/repo
g -C "$repo" init -q --template="$lab/template"
printf 'base\n' > "$repo/app.txt"
printf '*.log\n' > "$repo/.gitignore"
g -C "$repo" add -- app.txt .gitignore
g -C "$repo" -c user.name=Demo -c user.email=demo@example.org \
commit -qm baseline
# 脚本自己的契约:0 干净、1 有报告项、2 读取失败。
# 只判断输出是否为空,不拆解文件名,也不丢弃 Git 的 stderr。
check_clean() {
local changes
if changes=$(g -C "$1" status --porcelain=v1 --untracked-files=all); then
if [ -z "$changes" ]; then return 0; else return 1; fi
else
return 2
fi
}
expect() {
local name=$1 unstaged=$2 staged=$3 state=$4 a=0 b=0 c=0
g -C "$repo" diff --quiet -- || a=$?
g -C "$repo" diff --cached --quiet -- || b=$?
check_clean "$repo" || c=$?
if [ "$a:$b:$c" != "$unstaged:$staged:$state" ]; then
printf 'FAIL %s: got %s:%s:%s\n' "$name" "$a" "$b" "$c" >&2
exit 1
fi
printf 'PASS %s\n' "$name"
}
expect clean 0 0 0
printf 'edit\n' > "$repo/app.txt"
expect unstaged 1 0 1
g -C "$repo" add -- app.txt
expect staged 0 1 1
printf 'second edit\n' > "$repo/app.txt"
expect both 1 1 1
g -C "$repo" commit -qm staged-only
printf 'edit\n' > "$repo/app.txt"
printf 'new\n' > "$repo/new file.txt"
expect untracked 0 0 1
rm -- "$repo/new file.txt"
printf 'ignored\n' > "$repo/build.log"
expect ignored 0 0 0
actual=0
check_clean "$lab/outside" 2> "$lab/status.err" || actual=$?
diff_rc=0
g -C "$lab/outside" diff --quiet -- 2> "$lab/diff.err" || diff_rc=$?
if [ "$actual" -ne 2 ] || [ "$diff_rc" -le 1 ] || \
[ ! -s "$lab/status.err" ] || [ ! -s "$lab/diff.err" ]; then
printf 'FAIL outside repository: gate=%s diff=%s\n' "$actual" "$diff_rc" >&2
exit 1
fi
printf 'PASS not-a-repository\n'正常会收到七行 PASS。最值得对照的是 staged(0:1:1)、untracked(0:0:1)和 ignored(0:0:0);最后一项确认非仓库目录会走错误分支,而不是报告「干净」。这里的门禁码 2 是脚本约定,不是对 Git 自身故障码的统一规定。本次仅验证 Linux 下普通仓库和这些输入。
打包前,先确认传给 git -C 的确实是要打包的仓库,再跑状态检查。发现本地变化就把状态交给调用方;读取失败则保留原始诊断,不要自动 git add、重置文件或删目录来「修好」检查。构建步骤如果会在检查之后生成文件,还要单独验收最终包清单。
工作树状态是一次观察,不是快照锁。遇到并行写入、子模块、稀疏检出或刻意省略的路径,先定义队伍要检查的范围,再决定检查哪些路径、在哪一步检查。本文的普通仓库实验不等于验证了这些模式,也不替代 CI 实际出包验收。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。