Git Commit 的撤回与修改

reset（soft/mixed/hard）与 --amend 讲解
注意：

• 如果这个 commit 还没 push ：这个 reset 就是你要的（本地直接消失，文件状态回到 commit 前）。
• 如果已经 push 到远端了 ：不要用 reset 直接改历史（会影响别人）。
  通常用“反做一个 commit”：git revert HEAD

下面以“最近一次提交”为例（HEAD 指向最新 commit），用 3 个区域来理解 Git 当前状态：

• HEAD：最新提交（commit 历史）
• Index / Staging Area（暂存区）：git add 后准备提交的内容
• Working Tree（工作区）：你本地文件实际内容（未 add 的改动）

git reset 的本质：移动 HEAD（以及可选地同步暂存区/工作区），让你“回到某个 commit 的状态”。

---

1. 三种 reset 的核心区别（一句话版）

命令	HEAD（提交历史）	暂存区（Index）	工作区（Working Tree）	直观效果
git reset --soft HEAD~1	回退 1 个 commit	保留（不变）	保留（不变）	撤回 commit，但改动仍“已 add”
git reset --mixed HEAD~1（默认）	回退 1 个 commit	重置为目标 commit	保留（不变）	撤回 commit，改动留在工作区“未 add”
git reset --hard HEAD~1	回退 1 个 commit	重置	重置	撤回 commit，改动直接丢弃

小记：soft 最“温柔”，hard 最“暴力”，mixed 在中间（只清暂存区，不动工作区）。

---

2. git reset --soft HEAD~1：撤回 commit，但保留“已暂存”

适用场景

• 你提交了，但发现 漏加了文件 / 提交信息写错了 / 想把这次 commit 拆成多个 commit
• 你希望撤回 commit 后，改动仍处于 暂存区（已 add），方便直接重新 commit

执行后状态

• commit 历史：少了最新那次 commit（回到上一个）
• 暂存区：保持为“刚才那次 commit 的内容”
• 工作区：不变

常见用法：撤回后“减少一个文件再重新提交”

git reset --soft HEAD~1
git restore --staged path/to/file   # 把某文件从暂存区移出，但改动保留在工作区
git commit -m "new message"

---

3. git reset --mixed HEAD~1：撤回 commit，保留改动但变成“未暂存”

--mixed 是 git reset 的默认行为：不写参数时就是 mixed。

适用场景

• 你想撤回 commit，但重新挑选要提交的内容（重新 git add）
• 你想从“已提交”退回到“我再决定哪些要 add 的状态”

执行后状态

• commit 历史：回退 1 个 commit
• 暂存区：回到上一个 commit 的内容（等价于把之前 git add 的结果清掉）
• 工作区：仍保留你的改动（不会丢）

常见用法：撤回并重新组织提交内容

git reset --mixed HEAD~1
git add -p              # 分块挑选（可选，适合精修）
git commit -m "better commit"

---

4. git reset --hard HEAD~1：撤回 commit + 丢弃所有改动（慎用）

适用场景

• 你确认这次提交以及本地改动都不需要了
• 你想强制回到某个 commit 的“干净状态”
• 你本地搞坏了，想彻底恢复

执行后状态

• commit 历史：回退 1 个 commit
• 暂存区：重置
• 工作区：重置（本地文件直接变回目标 commit 的内容）

风险提示（非常重要）

• --hard 会让你看起来“代码都没了”。如果没有其他引用（比如还没 push、没有 stash、没有别的分支指向那个 commit），找回会更麻烦。
• 一般推荐先用：

git reset --mixed HEAD~1

确认没问题再考虑 hard。

---

5. git commit --amend：不撤回 commit，而是“修改最新一次 commit”

--amend 的本质：用一个新 commit 替换掉“最新 commit”（commit id 会变）。

适用场景

• 最新一次 commit 的：
  • 提交信息写错了
  • 少加了文件（补 git add 后 amend）
  • 想把小修补并进刚才那个 commit（保持历史干净）

使用方式

5.1 只改提交信息（不改内容）

git commit --amend

会打开编辑器让你改 message；如果你没改暂存区内容，commit 内容不变、只改 message。

5.2 补充文件到刚才那个 commit（最常用）

git add path/to/missed-file
git commit --amend

5.3 “从刚才 commit 里移除一个文件”（容易踩坑的正确做法）

git restore --staged path/to/file   # 先把它从暂存区移走（如果它在暂存区）
git commit --amend

但注意：如果那个文件的变更已经在最新 commit 里了，想从 commit 内容中移除，通常需要更明确的操作（比如把文件内容恢复到上一个 commit 的版本，再 amend）。常见写法：

git restore --source=HEAD~1 --staged --worktree path/to/file
git commit --amend

含义：把该文件在暂存区+工作区都恢复到“上一版”，再 amend 覆盖最新提交。

--amend 的注意事项

• 没 push 的情况下：非常适合用 amend（改历史很安全）
• 已 push 的情况下：amend 会改 commit id，通常需要 git push --force-with-lease，会影响协作，需谨慎

---

6. reset vs amend：怎么选？

你只是想“改最新一次 commit”（信息/补文件/合并小改动）

• 优先用：git commit --amend
• 优点：更直接、更符合“修正刚才的提交”的语义

你想“撤回 commit，但保留改动，重新组织提交”

• 用：git reset --soft HEAD~1（想保留已暂存）
• 或：git reset --mixed HEAD~1（想全部变未暂存再选）

你想“彻底丢弃这次提交和本地改动”

• 用：git reset --hard HEAD~1（慎用，确认再执行）

---