版本控制与协作 / 系统课时
修改最近一次提交
修改最近一次提交
学习目标
完成本课后,你将能够:
- 使用 commit --amend 修正最近提交
- 理解 amend 会创建新的提交对象
- 判断何时不应改写已共享历史
问题背景或应用场景
提交后立即发现说明写错或漏暂存一个小文件,是常见场景。删除提交再重做并非必要,git commit --amend 可以用当前暂存区和新说明替换最近一次提交。关键是理解它并不是原地编辑,而是创建新提交。
核心原理
amend 会以最近提交的父提交为基础,使用新的暂存区快照和元数据生成另一个提交,并让当前分支指向新对象。即使只修改提交说明,哈希也会变化。旧提交在短期内通常仍可通过 reflog 找到,但不再由当前分支引用。
尚未推送或仅个人使用的提交适合 amend。若旧提交已经推送并被他人基于其开发,改写后推送通常需要强制更新,会造成历史分叉。共享分支更安全的做法往往是创建新的修复提交。
基础用法
修正说明可运行 git commit --amend -m "新说明"。补充遗漏文件时,先 git add <file>,再运行 amend;使用 --no-edit 可以保留原说明。操作前记录旧哈希,操作后查看新哈希和差异,确认没有意外带入其他暂存内容。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。
bash
rm -rf git-amend-demo
mkdir git-amend-demo
cd git-amend-demo
git init -q
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "amend demo\n" > README.md
git add README.md
git commit -q -m "doc: add readme"
printf "before: "
git log -1 --format='%h %s'
git commit -q --amend -m "docs: add readme"
printf "after: "
git log -1 --format='%h %s'
printf "commit count: "
git rev-list --count HEAD预期输出
text
before: <OLD_COMMIT_ID> doc: add readme
after: <NEW_COMMIT_ID> docs: add readme
commit count: 1Tips
- amend 前先运行
git status,确认暂存区没有无关内容。 - 只修正说明时明确提供新说明,或进入编辑器仔细检查。
- 已共享提交需要改写时,应先与团队沟通并优先使用
--force-with-lease而非裸--force。
常见错误
1. 认为哈希不会变化
- 错误表现:外部记录仍引用旧提交。
- 正确处理:amend 是历史改写,操作后更新相关引用并确认是否已共享。
2. 无关文件被带入 amend
- 错误表现:暂存区原本还有其他内容。
- 正确处理:操作前检查暂存差异,只保留需要补充的文件。
本课练习
1. 修正提交说明
- 任务目标:修正提交说明。
- 输入或初始条件:创建一条拼写错误的本地提交。
- 实现要求:使用 amend 修正并比较前后哈希。
- 验收条件:提交数量不变,哈希和说明改变。
2. 补充遗漏文件
- 任务目标:补充遗漏文件。
- 输入或初始条件:提交后新建一个应属于同一目的的测试文件。
- 实现要求:暂存后用
--no-editamend。 - 验收条件:最近提交同时包含两个文件。
3. 判断安全边界
- 任务目标:判断安全边界。
- 输入或初始条件:设计未推送、个人远程分支、共享主分支三种场景。
- 实现要求:分别选择 amend 或新提交。
- 验收条件:选择能说明对协作者的影响。
按自己的节奏,确认真正理解。