版本控制与协作 / 系统课时
理解工作区、暂存区与版本库
理解工作区、暂存区与版本库
学习目标
完成本课后,你将能够:
- 建立工作区、暂存区和版本库模型
- 判断一次修改当前位于哪个区域
- 理解 add 与 commit 的数据流向
核心原理
工作区是当前可见和编辑的文件;暂存区也称 index,保存“下一次提交准备记录的内容”;版本库保存已经创建的提交对象。git add 把工作区选定内容写入暂存区,git commit 根据暂存区创建新提交。
暂存区不是简单的文件名单,而是每个路径准备提交的完整内容快照。同一个文件在暂存后继续修改,会同时出现“已暂存版本”和“工作区新修改”,因此一次文件可能对应三个不同内容:HEAD 中的版本、暂存区版本和工作区版本。

基础用法
使用 git status --short 可以快速观察区域变化:左列表示暂存区相对 HEAD 的状态,右列表示工作区相对暂存区的状态。git diff 比较工作区与暂存区,git diff --staged 比较暂存区与最近提交。提交前应同时检查状态和两类差异。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。
bash
rm -rf git-three-areas-demo
mkdir git-three-areas-demo
cd git-three-areas-demo
git init -q
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "line 1\n" > notes.txt
printf "after create: "
git status --short
git add notes.txt
printf "after add: "
git status --short
git commit -q -m "docs: add notes"
printf "after commit: "
git status --short
printf "line 2\n" >> notes.txt
printf "after modify: "
git status --short预期输出
text
after create: ?? notes.txt
after add: A notes.txt
after commit: after modify: M notes.txtTips
- 把暂存区理解为“下一次提交的购物车”,提交前可以增删其中内容。
- 文件暂存后再次编辑时,使用两种 diff 分别检查暂存和未暂存内容。
- 提交是否完整应以暂存区为准,而不是以编辑器已保存为准。
常见错误
1. 执行 add 后以为已经有历史版本
- 错误表现:关闭仓库或重置后发现没有提交可恢复。
- 正确处理:
git add只准备内容,还必须执行git commit创建版本。
2. 取消暂存时误删工作区修改
- 错误表现:使用不合适的硬重置导致内容丢失。
- 正确处理:仅取消暂存优先使用
git restore --staged <file>,它会保留工作区内容。
本课练习
1. 观察三次状态
- 任务目标:观察三次状态。
- 输入或初始条件:新建一个仓库和文件。
- 实现要求:依次在创建、暂存、提交后记录短状态。
- 验收条件:能够解释每次状态字符。
2. 制造双重修改
- 任务目标:制造双重修改。
- 输入或初始条件:先暂存文件,再继续追加一行。
- 实现要求:查看短状态和两类 diff。
- 验收条件:同一文件同时显示暂存与未暂存变化。
3. 选择提交内容
- 任务目标:选择提交内容。
- 输入或初始条件:准备两个已修改文件。
- 实现要求:只暂存其中一个并提交。
- 验收条件:提交后另一个文件仍保留未提交修改。
按自己的节奏,确认真正理解。