版本控制与协作 / 系统课时
将文件加入暂存区
将文件加入暂存区
学习目标
完成本课后,你将能够:
- 使用 git add 选择提交内容
- 掌握单文件、多文件和目录暂存
- 检查暂存区实际包含的差异
核心原理
git add 根据指定路径读取当前工作区内容并更新暂存区。它既能暂存新文件和修改,也能记录删除。暂存之后文件再次变化时,暂存区仍保留当时版本,必须再次执行 git add 才会更新。
git add . 以当前目录为路径范围,通常会包含该目录下的新增、修改和删除;git add -A 以整个工作树为范围。二者在仓库子目录执行时范围可能不同,因此批量操作前应先看状态,操作后使用 git diff --staged 检查实际内容。
基础用法
最安全的流程是先按文件暂存:git add README.md src/app.js。修改跨度较大时可使用 git add -p 逐块选择,但交互式暂存需要理解每个补丁块。无论使用哪种方式,都应在提交前运行 git diff --staged --stat 和完整差异检查。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。
bash
rm -rf git-add-demo
mkdir git-add-demo
cd git-add-demo
git init -q
printf "alpha\n" > a.txt
printf "beta\n" > b.txt
printf "temporary\n" > debug.log
git add a.txt b.txt
printf "staged files:\n"
git diff --staged --name-status
printf "remaining files:\n"
git status --short预期输出
text
staged files:
A a.txt
A b.txt
remaining files:
A a.txt
A b.txt
?? debug.logTips
- 优先按路径暂存,确认无误后再考虑
git add .。 - 暂存区是可修改的,发现选错文件时可以取消暂存而保留工作区内容。
- 对大型或混合修改使用
git add -p,让一个文件中的不同逻辑进入不同提交。
常见错误
1. 盲目执行 git add .
- 错误表现:调试日志和本地配置被一起暂存。
- 正确处理:先查看状态,按路径选择;同时完善
.gitignore。
2. 暂存后继续编辑却未再次 add
- 错误表现:提交中缺少刚刚完成的最后修改。
- 正确处理:提交前检查
git diff和git diff --staged,需要时重新暂存。
本课练习
1. 选择两个文件
- 任务目标:选择两个文件。
- 输入或初始条件:准备三个未跟踪文件。
- 实现要求:只暂存其中两个。
- 验收条件:短状态显示两个 A 和一个 ??。
2. 更新已暂存内容
- 任务目标:更新已暂存内容。
- 输入或初始条件:暂存文件后再追加一行。
- 实现要求:比较两类 diff,再次暂存。
- 验收条件:最终未暂存差异为空。
3. 练习交互暂存
- 任务目标:练习交互暂存。
- 输入或初始条件:在同一文件修改两个相距较远的位置。
- 实现要求:使用
git add -p只选择一个补丁块。 - 验收条件:暂存差异只包含选中的修改。
按自己的节奏,确认真正理解。