← 返回首页

第2章: 工作区、暂存区与提交

搞清楚文件从「修改」到「记录到历史」的完整流程

三个重要概念

工作区（Working Directory）： 你平时编辑文件所在的目录
暂存区（Stage/Index）： 用来临时存放「本次打算提交的改动」
本地仓库（Repository）： 永久保存提交历史的地方

记忆法： 修改在工作区；选中要提交的放进暂存区；最后一次性提交到本地仓库。

常用基础命令

1. 查看状态

git status

2. 把修改加入暂存区

# 添加单个文件
git add readme.txt

# 添加所有修改
git add .

3. 提交到本地仓库

git commit -m "描述本次修改的说明"

更像真实开发的“提交习惯”

1) 只提交你想提交的那部分（非常重要）

一个文件里可能同时做了两类改动：比如修 bug + 顺手改格式。建议拆成两次提交，方便回溯与 review。

# 交互式暂存（按块选择）
git add -p

2) 写好 commit message（让未来的你感谢现在的你）

建议格式：动词开头 + 说明范围，例如：Fix login redirect / Add README usage
尽量避免：update、fix 这种没有信息量的描述

课堂互动：让学员把同一个改动写 2 个 message：一个糟糕的、一个清晰的，比较差异。

3) 提交后发现 message 写错了？（仅限未 push）

# 修改最近一次提交的 message（未推送前使用）
git commit --amend -m "New message"

.gitignore：让 Git 忽略不该提交的文件

例如：日志、构建产物、IDE 配置。把它们写进 .gitignore，避免污染仓库。

# Java
target/
*.log

# IDE
.idea/
.vscode/

# OS
.DS_Store

注意：已经被 Git 跟踪的文件，后来加入 .gitignore 不会自动消失，需要先从索引移除（后面章节会再讲）。

常见坑

忘了 add 就 commit：提交里没有包含你的修改（先 git status 看清楚再 commit）
一口气 add .：把不该提交的文件也带上（优先用 git add 文件 或 git add -p）
提交太大：一次提交改动过多，后续回溯与 review 成本高（建议拆小提交）

一次完整的提交流程演示

在上一章创建的仓库 my-first-git-project 中，尝试下面流程：

# 1. 查看当前状态
git status

# 2. 编辑 readme.txt（用你喜欢的编辑器）
#   比如加上一行："This is my first git repo."

# 3. 再次查看状态
git status

# 4. 把 readme.txt 放入暂存区
git add readme.txt

# 5. 提交到本地仓库
git commit -m "Update readme with description"

提交成功后，Git 会给出本次提交的概要信息（包括修改了多少行）。

📝 章节练习

练习 1：多次修改、一次提交

在仓库中新建 todo.txt，写三条待办事项
多次修改这个文件（例如添加/删除几条），中间随时用 git status 观察状态
最后用一次 git add todo.txt，一次 git commit 完成提交

练习 2：只提交部分文件

同时修改两个文件：readme.txt 和 todo.txt
只把 readme.txt 加入暂存区并提交
观察 git status 输出，理解「已暂存」和「未暂存」的区别

本章小结

理解了工作区、暂存区、本地仓库三者的关系
掌握了 git status、git add 和 git commit 的基本使用
能够完成从修改文件到成功提交的一整套流程
了解了更贴近真实开发的技巧：git add -p、commit --amend、以及 .gitignore