02-first-commit.md

第 2 课：完成第一次提交

本课修改 practice/profile.md，完成一个小而清晰的 commit。

1. 开始前确认状态

git switch main
git pull --ff-only
git status

如果 git status 不是 working tree clean，先弄清已有改动，不能盲目继续。

2. 创建练习分支

git switch -c docs/update-profile
git branch --show-current

switch -c 表示创建并切换。分支只是一个指向 commit 的轻量名字，不是复制整个项目文件夹。

3. 修改文件

用 VS Code 或文本编辑器打开 practice/profile.md，填写 GitHub 用户名，把学习进度改为“第 2 天”，保存文件。

查看变化：

git status
git diff -- practice/profile.md

在 git diff 中：

• - 开头是删除的旧行；
• + 开头是增加的新行；
• 这里只是查看，不会修改文件。

4. 加入暂存区

git add practice/profile.md
git status
git diff --staged

此时文件应出现在 Changes to be committed 下。暂存区的意义是让你精确选择下一次 commit 的内容。

如果加错文件，取消暂存但保留修改：

git restore --staged practice/profile.md

然后重新 git add。

5. 创建 commit

git commit -m "docs: update learning profile"
git log -1 --oneline
git status

一次好的 commit 应该：

• 可以独立解释；
• 不混入无关格式化或秘密文件；
• 信息描述“做了什么”，例如 fix: reject empty task title。

6. 检查 commit 内容

git show --stat HEAD
git show HEAD -- practice/profile.md

HEAD 表示当前所在分支的最新 commit。SHA 是 commit 的唯一标识，通常前 7～12 位就够日常使用。

自测

不看上面的步骤，再给 practice/profile.md 增加一行“最常用命令：git status”，完成第二个 commit：

docs: add favorite Git command

提交前必须依次执行 status、diff、add、diff --staged。