1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 恢复单个文件到上次提交的状态
#（丢弃工作区的所有改动）
git restore path/to/file.js

# 恢复多个文件
git restore file1.js file2.js

# 恢复整个目录
git restore src/

# 恢复所有文件（慎用！）
git restore .

1
2
3
4

# 你在 src/feature.js 上改了半天，发现完全走偏了
# 一键恢复，从头再来
git restore src/feature.js
# 文件回到了上次 commit 的状态，你的改动全部消失

1
2
3
4

# 你不小心删光了 config.js 的内容并保存了
# 恢复它
git restore config.js
# 文件内容回来了！

1
2
3
4
5
6
7
8

# 从暂存区恢复（取消工作区的改动，保留暂存区）
git restore --staged --worktree path/to/file.js

# 从某个提交恢复
git restore --source=HEAD~3 path/to/file.js

# 从某个分支恢复
git restore --source=feature-branch path/to/file.js

1
2
3
4
5
6
7
8
9

# 交互式选择要恢复的内容
git restore --patch path/to/file.js

# Git 会逐个显示改动块，问你：
# Apply this hunk [y,n,q,a,d,j,J,g,/,e,?]? 
# y = yes（恢复这个块）
# n = no（保留这个块）
# q = quit（退出）
# ? = help（查看帮助）

1
2
3
4
5
6
7
8

# 将文件从暂存区移除，但保留工作区的改动
git restore --staged path/to/file.js

# 移除多个文件
git restore --staged file1.js file2.js

# 移除所有文件
git restore --staged .

1
2
3
4
5
6
7
8
9

# 你修改了 config.js，但里面包含敏感信息
# 不小心执行了 git add config.js

# 从暂存区移除
git restore --staged config.js

# 现在 config.js 还在工作区，但不在暂存区了
# 你可以把它加到 .gitignore，或者恢复工作区的改动
git restore config.js  # 如果你也想丢弃工作区的改动

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 你修改了 3 个文件，但想分成两次提交
# 不小心一次性都 add 了

git add .

# 把其中一个文件从暂存区移除
git restore --staged file3.js

# 现在暂存区只有 file1.js 和 file2.js
git commit -m "feat: 添加功能 A"

# 再提交 file3.js
git add file3.js
git commit -m "feat: 添加功能 B"

1
2

# 撤销提交，但保留改动在暂存区
git reset --soft HEAD~1

1
2
3
4
5
6
7
8
9

# 刚才的提交信息写错了
git commit -m "fix: 修复了 bug"
# 突然想起来，应该写 "fix: 修复登录失败的 bug"

# 撤销提交，但保留改动
git reset --soft HEAD~1

# 重新提交
git commit -m "fix: 修复登录失败的 bug"

1
2
3
4

# 撤销提交，改动退回到工作区
git reset --mixed HEAD~1
# 或者简写（--mixed 是默认模式）
git reset HEAD~1

1
2
3
4
5
6
7
8
9

# 提交后发现漏了 utils.js
git commit -m "feat: 添加新功能"

# 撤销提交，改动回到工作区
git reset HEAD~1

# 现在所有改动都在工作区，重新 add
git add src/feature.js utils.js
git commit -m "feat: 添加新功能（包含工具函数）"

1
2

# 彻底撤销提交，所有改动消失
git reset --hard HEAD~1

1
2
3
4
5
6
7

# 你提交了一堆实验性的代码，现在决定不要了
git commit -m "WIP: 实验性功能"

# 彻底删除这次提交和所有改动
git reset --hard HEAD~1

# 世界清净了，就像什么都没发生过

1
2
3
4
5
6
7
8

# 回到某个特定的提交
git reset --hard a1b2c3d

# 回到某个标签
git reset --hard v1.0.0

# 回到某个分支的最新提交
git reset --hard feature-branch

1
2
3
4
5
6

# 如果不确定要不要保留改动，先用 --mixed
git reset --mixed HEAD~1

# 如果发现还需要某些改动，可以重新 add
# 如果确实都不需要，再执行 --hard
git reset --hard HEAD

1
2
3
4
5
6
7
8

# 提交前，如果改动很重要，先 stash 一下
git stash push -m "备份：实验性功能"

# 然后放心地 reset
git reset --hard HEAD~1

# 如果后悔了，可以恢复
git stash pop

1
2
3
4

# 即使执行了 reset --hard，也可以用 reflog 找回
git reflog
# 找到 reset 之前的提交哈希
git reset --hard a1b2c3d  # 回到那个提交

1
2
3
4
5

# 完蛋，执行了 --hard，但发现还有文件需要
# 解决方案：用 reflog 找回
git reflog
# 找到执行 reset --hard 之前的提交
git reset --hard HEAD@{1}

1
2
3
4
5
6

# 错误：想从暂存区移除文件，结果用了 --hard
# 工作区的改动也没了！

# 正确做法：
git restore --staged file.js  # 从暂存区移除
git restore file.js          # 如果要丢弃工作区的改动

1
2
3
4

# 你在 main 分支上 reset 了已经 push 的提交
# 这会改变历史，导致团队成员困惑

# 解决方案：用 git revert 代替（见下一节）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 撤销某次提交
git revert a1b2c3d

# 撤销最近的提交
git revert HEAD

# 撤销前两次提交（分别创建两个 revert 提交）
git revert HEAD~2..HEAD

# 撤销但不自动提交（手动处理）
git revert --no-commit HEAD

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 你发现提交 a1b2c3d 引入了 Bug，已经 push 到远程

# 安全地撤销
git revert a1b2c3d

# 编辑器会打开，让你编辑 revert 的提交信息
# 保存后，Git 会创建一个新的提交

# 推送到远程
git push origin main

1
2
3

# 撤销一个合并提交需要指定父分支
# 通常 -m 1 表示保留 main 分支的改动，撤销 feature 分支的改动
git revert -m 1 a1b2c3d

1
2
3
4
5
6

# 撤销最近 3 个提交（创建 3 个 revert 提交）
git revert HEAD~3..HEAD

# 或者合并成一个提交
git revert --no-commit HEAD~3..HEAD
git commit -m "revert: 撤销最近 3 个实验性提交"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# revert 时遇到冲突
git revert a1b2c3d
# Auto-merging src/feature.js
# CONFLICT (content): Merge conflict in src/feature.js
# error: could not revert a1b2c3d... 添加新功能
# hint: after resolving the conflicts, mark them with
# hint: "git add/rm <pathspec>", then run
# hint: "git revert --continue"
# hint: you can abort the revert with
# hint: "git revert --abort"

# 解决冲突后
git add src/feature.js
git revert --continue

1
2
3
4
5
6
7
8

# 查看 HEAD 的变动历史
git reflog

# 查看某个分支的变动历史
git reflog show main

# 查看相对时间
git reflog --date=relative

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 1. 查看 reflog，找到 reset 之前的提交
git reflog
# 输出：
# b2c3d4e HEAD@{0}: reset: moving to HEAD~1
# c3d4e5f HEAD@{1}: commit: WIP: 实验性功能  ← 这就是我们要找的

# 2. 确认这就是你要找的提交
git show c3d4e5f

# 3. 恢复这个提交
git reset --hard c3d4e5f

# 或者，如果你想保留当前状态，创建一个分支
git checkout -b recovered-work c3d4e5f

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 你不小心删除了 feature-x 分支

# 1. 在 reflog 中找 feature-x 的最后一次提交
git reflog
# 输出：
# d4e5f6g HEAD@{3}: checkout: moving from feature-x to main
# e5f6g7h HEAD@{4}: commit: 添加功能 X  ← feature-x 的最后一次提交

# 2. 恢复分支
git checkout -b feature-x e5f6g7h

# feature-x 分支复活了！

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 你不小心执行了 git stash drop

# 1. 查看 stash 的 reflog
git reflog show stash

# 2. 恢复 stash
git stash store a1b2c3d -m "恢复的 stash"

# 或者直接用那个提交创建分支
git checkout -b recovered-stash a1b2c3d

1
2
3
4
5

# 查看 reflog 过期时间配置
git config gc.reflogExpire

# 修改过期时间（不推荐，除非你知道在做什么）
git config gc.reflogExpire "180 days"

1
2
3
4
5
6
7
8

# 你不小心 rm 了重要文件
rm important.js

# 文件还在工作区，用 restore 恢复
git restore important.js

# 如果文件已经被 git add 过，也可以用 checkout
git checkout -- important.js

1
2
3
4
5
6
7
8
9

# 你执行了 git rm 或 rm + git add
git rm important.js

# 文件在暂存区标记为删除，但还没 commit
# 从暂存区移除删除标记
git restore --staged important.js

# 恢复文件内容
git restore important.js

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 你已经提交了删除操作
git rm important.js
git commit -m "删除 important.js"

# 方案1：用 revert 撤销删除提交
git revert HEAD

# 方案2：从之前的提交恢复文件
git checkout HEAD~1 -- important.js
git commit -m "恢复 important.js"

1
2
3
4
5
6
7

# 你执行了 git filter-branch 或 git filter-repo 彻底删除了文件
# 这种情况比较复杂...

# 如果你有其他备份（比如其他克隆的仓库、CI/CD 缓存等），从备份恢复

# 如果没有备份... 祈祷吧 🙏
# 下次记得：重要文件要多重备份！

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 1. 使用 trash 命令代替 rm（可恢复）
trash file.js  # 而不是 rm file.js

# 2. 删除前确认
git status  # 看看会删除什么

# 3. 重要操作前创建分支
git checkout -b backup-before-dangerous-operation

# 4. 定期 push 到远程
# 即使本地彻底删除，远程还有备份

1
2
3
4
5

# 重要改动前先 stash
git stash push -m "备份"

# 或者创建分支
git checkout -b backup

1
2
3
4
5

# 不确定要不要保留改动时
git reset --mixed HEAD~1

# 这样改动还在工作区，可以检查
# 确定不要了再执行 --hard

1
2
3

# 在 main、develop 等公共分支上
# 永远用 revert 代替 reset
git revert HEAD

1
2
3

# 经常 push 到远程
# 即使本地彻底删除，远程还有备份
git push origin main

1
2
3
4
5
6
7
8

# 重要改动前，先 stash
git stash push -m "WIP: 重构前的备份"

# 或者创建备份分支
git branch backup-before-refactor

# 或者 push 到远程
git push origin feature-branch

1
2
3
4
5

# 恢复前，先看看要恢复什么
git restore --patch file.js

# 提交前，再确认一下要提交什么
git add --patch file.js

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 不要积累大量改动再提交
# 小步提交，即使出问题也容易恢复

# 不好：
git add .
git commit -m "做了很多改动"

# 好：
git add src/feature.js
git commit -m "feat: 添加用户登录功能"

git add tests/
git commit -m "test: 添加登录功能测试"

1
2
3
4
5
6

# commit 后，先验证
git log --oneline -3  # 看看提交历史
git show HEAD         # 看看最后一次提交的内容

# 确认无误后再 push
git push origin main

1
2
3
4
5
6

# 不确定命令的作用？先查文档
git reset --help

# 或者用 --dry-run（如果支持）
# 虽然 git reset 不支持 --dry-run，但你可以：
git log HEAD~3..HEAD  # 看看会丢失什么提交

1
2
3
4
5
6

# 个人分支：随意 reset/rebase
# 公共分支：只用 revert

# 强制 push 前，通知团队
# 使用 --force-with-lease 代替 --force
git push --force-with-lease origin main

1
2
3
4
5
6
7
8
9

# 定期查看 reflog，了解最近的操作
git reflog --date=relative

# 定期运行 fsck 检查仓库健康
git fsck

# 定期备份重要仓库
# 可以 push 到多个远程，或者打包备份
git bundle create backup.bundle --all