撤销与回退：restore、reset 三模式与 revert

     工作区              暂存区              仓库(已提交)
        |                   |                    |
  git restore <f>    git restore --staged   reset / revert / amend
   丢弃未暂存改动       取消暂存(改动保留)      回退或反做提交

git init -q
echo 'good' > a.txt
echo 'good' > b.txt
git add . && git commit -q -m "init"
 
echo '===== 场景1：文件改坏了，想丢弃改动 ====='
echo 'OOPS 改坏了' > a.txt
git status --short
git restore a.txt
echo 'restore 后 a.txt 内容：' && cat a.txt
git status --short
echo '(没有输出 = 干净了)'
echo
 
echo '===== 场景2：add 错了，想取消暂存但保留改动 ====='
echo 'wip' > b.txt
git add b.txt
echo 'add 之后：' && git status --short
git restore --staged b.txt
echo 'restore --staged 之后：' && git status --short
echo 'b.txt 内容仍然是：' && cat b.txt
echo '(只是从暂存区退回工作区，内容没丢)'
echo
 
echo '===== 场景3：把文件恢复成某个历史提交的样子 ====='
echo 'v2' > a.txt && git add . && git commit -q -m "v2"
echo 'v3' > a.txt && git add . && git commit -q -m "v3"
echo '当前 a.txt：' && cat a.txt
git restore --source=HEAD~2 a.txt
echo '恢复到 HEAD~2 后：' && cat a.txt
git status --short
echo '(恢复的内容作为「未暂存改动」出现，你可以决定要不要提交)'

                    移动分支指针   重置暂存区   重置工作区
git reset --soft       是            否          否
git reset --mixed      是            是          否     <- 默认
git reset --hard       是            是          是     <- 危险

setup() {
  git init -q $1 && cd $1
  for i in 1 2 3; do
    echo "v$i" > f.txt
    git add . && git commit -q -m "commit-$i"
  done
  # 制造一个已暂存的未提交改动
  echo 'uncommitted-edit' >> f.txt
  git add f.txt
  cd ..
}
 
for MODE in soft mixed hard; do
  setup r-$MODE
  cd r-$MODE
  echo "########## git reset --$MODE HEAD~1 ##########"
  echo '--- 重置前：3 个提交 + 1 个已暂存改动 ---'
  git log --oneline | head -3
  git status --short
  git reset --$MODE HEAD~1 >/dev/null 2>&1
  echo '--- 重置后 ---'
  echo 'log:'
  git log --oneline | head -3
  echo 'status:'
  git status --short
  echo 'f.txt 内容:'
  cat f.txt
  echo
  cd ..
done

# 撤销上一个提交，内容留在暂存区，准备重新提交
git reset --soft HEAD~1
 
# 把最近 3 个提交合并成 1 个（软退 3 步再提交一次）
git reset --soft HEAD~3
git commit -m "feat: 完整的功能实现"
 
# 取消暂存（reset 的老写法，等价于 git restore --staged）
git reset HEAD file.txt
 
# 彻底放弃本地所有改动，回到远程的样子（危险但常用）
git reset --hard origin/main

git init -q
echo 'feature A' > a.txt && git add . && git commit -q -m "feat: A"
echo 'feature B 有bug' > b.txt && git add . && git commit -q -m "feat: B 带 bug"
echo 'feature C' > c.txt && git add . && git commit -q -m "feat: C"
 
echo '===== 当前状态 ====='
git log --oneline
echo '文件:' && ls
echo
 
echo '===== 只想撤销中间的 B（reset 会连 C 一起丢，所以只能 revert）====='
BAD=$(git log --grep='B 带 bug' --format=%H)
git revert --no-edit $BAD
echo
 
echo '===== 历史只增不减：多了一个反向提交，C 完好无损 ====='
git log --oneline
echo '文件（b.txt 没了，c.txt 还在）:' && ls
echo
 
echo '===== revert 掉那个 revert，就等于把 B 加回来 ====='
git revert --no-edit HEAD
git log --oneline
echo '文件:' && ls

# 只改提交信息
git commit --amend -m "fix(auth): 正确的提交信息"
 
# 补一个漏掉的文件进上一个提交
git add forgotten.py
git commit --amend --no-edit      # --no-edit 表示沿用原来的提交信息

原始历史：   A --- B --- C --- D (main)
 
git reset --hard B:
             A --- B (main)          C、D 从分支上消失（对象还在，靠 reflog 找）
             
git revert C:
             A --- B --- C --- D --- C' (main)   C' 是 C 的反操作，历史完整保留