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

将文件加入暂存区

将文件加入暂存区

学习目标

完成本课后,你将能够:

  • 使用 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.log

Tips

  • 优先按路径暂存,确认无误后再考虑 git add .。
  • 暂存区是可修改的,发现选错文件时可以取消暂存而保留工作区内容。
  • 对大型或混合修改使用 git add -p,让一个文件中的不同逻辑进入不同提交。

常见错误

1. 盲目执行 git add .

  • 错误表现:调试日志和本地配置被一起暂存。
  • 正确处理:先查看状态,按路径选择;同时完善 .gitignore。

2. 暂存后继续编辑却未再次 add

  • 错误表现:提交中缺少刚刚完成的最后修改。
  • 正确处理:提交前检查 git diff 和 git diff --staged,需要时重新暂存。

本课练习

1. 选择两个文件

  • 任务目标:选择两个文件。
  • 输入或初始条件:准备三个未跟踪文件。
  • 实现要求:只暂存其中两个。
  • 验收条件:短状态显示两个 A 和一个 ??。

2. 更新已暂存内容

  • 任务目标:更新已暂存内容。
  • 输入或初始条件:暂存文件后再追加一行。
  • 实现要求:比较两类 diff,再次暂存。
  • 验收条件:最终未暂存差异为空。

3. 练习交互暂存

  • 任务目标:练习交互暂存。
  • 输入或初始条件:在同一文件修改两个相距较远的位置。
  • 实现要求:使用 git add -p 只选择一个补丁块。
  • 验收条件:暂存差异只包含选中的修改。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

将文件加入暂存区

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

登录哪都通