版本控制与协作 / 系统课时

比较暂存区与最近提交

比较暂存区与最近提交

学习目标

完成本课后,你将能够:

  • 使用 git diff --staged 检查待提交内容
  • 区分未暂存与已暂存差异
  • 在提交前完成最终内容审查

问题背景或应用场景

暂存成功不代表选择一定正确。下一次提交只取暂存区内容,因此提交前最关键的审查对象是暂存区相对 HEAD 的差异。git diff --staged 能准确展示“按下 commit 后会进入新快照的内容”。

核心原理

git diff --staged 与 git diff --cached 含义相同,比较暂存区和当前 HEAD。新仓库尚无 HEAD 时,它会把暂存内容与空树比较。文件暂存后继续编辑,staged diff 仍显示暂存时版本,而默认 diff 显示后续工作区修改。

这种双重状态允许开发者提交一个稳定子集并保留未完成工作,但也带来漏提交风险。提交前应同时确认 staged diff 是所需内容、默认 diff 中剩余内容是否有意保留。

基础用法

推荐检查顺序:git status --short 查看范围,git diff --staged --stat 查看规模,git diff --staged 查看完整内容,最后再提交。发现暂存错误时使用 git restore --staged <path> 取消暂存,工作区修改仍然保留。

完整可运行示例

以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。

bash
rm -rf git-diff-staged-demo
mkdir git-diff-staged-demo
cd git-diff-staged-demo
git init -q
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "level=info\n" > log.conf
git add log.conf
git commit -q -m "chore: add log config"
printf "level=debug\n" > log.conf
git add log.conf
printf "level=warn\n" > log.conf
printf "staged version:\n"
git diff --staged -- log.conf
printf "working version:\n"
git diff -- log.conf

预期输出

text
staged version:
diff --git a/log.conf b/log.conf
--- a/log.conf
+++ b/log.conf
@@ -1 +1 @@
-level=info
+level=debug
working version:
diff --git a/log.conf b/log.conf
--- a/log.conf
+++ b/log.conf
@@ -1 +1 @@
-level=debug
+level=warn

Tips

  • 把 staged diff 当作提交前的最终清单。
  • 暂存后继续编辑时,务必检查两类差异。
  • 取消暂存不会自动撤销工作区内容。

常见错误

1. 只检查默认 diff

  • 错误表现:提交中包含未注意到的暂存内容。
  • 正确处理:提交前必须运行 git diff --staged。

2. 误以为取消暂存会丢修改

  • 错误表现:不敢调整暂存区。
  • 正确处理:git restore --staged 只移动区域,工作区内容仍在。

本课练习

1. 制造三版本文件

  • 任务目标:制造三版本文件。
  • 输入或初始条件:提交 v1,暂存 v2,工作区改为 v3。
  • 实现要求:分别查看两类 diff。
  • 验收条件:能够指出每个比较的基准与目标。

2. 修正暂存选择

  • 任务目标:修正暂存选择。
  • 输入或初始条件:错误暂存两个文件。
  • 实现要求:取消其中一个暂存。
  • 验收条件:目标文件仍保持工作区修改。

3. 提交稳定子集

  • 任务目标:提交稳定子集。
  • 输入或初始条件:一个文件有暂存和未暂存变化。
  • 实现要求:只提交暂存版本。
  • 验收条件:提交后工作区仍保留后续变化。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

比较暂存区与最近提交

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通