首页/开发/Git 与协作速查/git diff --staged 复核待提交内容
Git 基础与命令88 条

git diff --staged 复核待提交内容

检查即将进入提交的改动:--staged 等价 --cached,比较暂存区与 HEAD,是提交前的一道复核。

Git 与协作速查开发更新于 2026-10-12
用途复核即将提交的内容
语法git diff --staged [--stat]
别名--cached 完全等价

常用示例

常用示例
git diff --staged
git diff --staged --stat
git diff --cached --name-only
配合 git add -p 的节奏:先组好暂存内容,再用 --staged 通读一遍,提交质量明显提升。

易错点

  • 新文件必须先 git add 才会出现在 --staged 输出中
  • 部分暂存时暂存与工作区各有一半改动,两个 diff 视角都要看

数据来源与参考

  • Git 官方文档:git-diff(--cached/--staged)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌