Git 回退提交保留文件修改

场景

需要回退最近的 N 次提交，但希望文件修改保留在工作目录中（变为未提交状态），方便重新编辑或重新提交。

命令

# 回退最近 N 次提交，修改保留在工作区（unstaged）
git reset --mixed HEAD~N

# 或直接回退到指定 commit
git reset --mixed <target-commit>

# 如果连带远程也想清理
git push --force origin <branch>

三种 reset 模式的区别

模式	HEAD 位置	暂存区 (Staging)	工作目录 (Working Dir)
--soft	✅ 移动	✅ 保留	✅ 保留
--mixed（默认）	✅ 移动	❌ 清空	✅ 保留
--hard	✅ 移动	❌ 清空	❌ 清空

• --soft：撤销提交，改动还在 暂存区，直接 git commit 即可
• --mixed：撤销提交，改动回到 工作区，需先 git add 再 git commit
• --hard：⚠️ 危险！彻底扔掉改动，不可恢复

实际案例

回退 3 次提交到 caf265e：

# 1. 查看提交历史
git log --oneline

# 2. 回退到目标 commit，保留修改
git reset --mixed caf265e

# 3. 确认状态
git status        # 查看保留的文件
git log --oneline # HEAD 已指向目标

# 4. 如需同步远程（覆盖远程历史）
git push --force origin main

注意

• git reset 只影响本地分支，远程分支不受影响
• 需要清理远程时，必须 git push --force，这是破坏性操作，多人协作需谨慎
• 如果只想撤销提交但保持文件可随时重新提交，用 --soft 更省事