当前位置：首页 > news >正文

git进阶07_Git 高级技巧与故障排查

news 2026/6/30 7:00:02

06 - Git 高级技巧与故障排查

本章目标：掌握企业实战中的高级 Git 技巧，能独立排查和解决各种 Git 故障。

一、git reflog — 救命神器

这是 Git 最被低估的功能，关键时刻能救你的命。

# 查看所有操作记录（包括已经 reset 掉的 commit）gitreflog# 输出示例：# abc1234 HEAD@{0}: reset: moving to HEAD~3# def5678 HEAD@{1}: commit: feat: add login# ghi9012 HEAD@{2}: commit: feat: add register# jkl3456 HEAD@{3}: commit: feat: add dashboard

常见救命场景

# 场景1：误删了分支gitbranch-Dfeature/important# 没关系！gitreflog# 找到分支最后的 commitgitcheckout-bfeature/important abc1234# 恢复# 场景2：误执行了 git reset --hardgitreflog# 找到 reset 前的 commitgitreset--hardabc1234# 恢复# 场景3：push 后发现代码有问题gitreflog# 找到 push 前的 commitgitreset--hardabc1234# 回退gitpush --force-with-lease# 强制推送（回退远程）

二、git reset 的三种模式

# ===== 模式对比 =====# --soft：只撤销 commit，保留暂存区和工作区gitreset--softHEAD~1# 效果：commit 被撤销，改动仍在暂存区（绿色）# --mixed（默认）：撤销 commit + 暂存区，保留工作区gitreset HEAD~1# 效果：commit 被撤销，改动在工作区（红色）# --hard：全部撤销（危险！不可恢复）gitreset--hardHEAD~1# 效果：commit、暂存区、工作区全部撤销

--soft --mixed --hard ┌──────────┐ ┌──────────┐ ┌──────────┐ 暂存区（Staged） │ 保留 ✅ │ │ 清空 ❌ │ │ 清空 ❌ │ ├──────────┤ ├──────────┤ ├──────────┤ 工作区（Working） │ 保留 ✅ │ │ 保留 ✅ │ │ 清空 ❌ │ └──────────┘ └──────────┘ └──────────┘

使用场景

# 修改最近一次 commit 的内容gitaddforgotten-file.jsgitcommit--amend--no-edit# 或者gitaddforgotten-file.jsgitreset--softHEAD~1gitcommit-m"feat: add login (with forgotten file)"# 撤销最近一次 commit（保留改动）gitreset HEAD~1# 彻底回退到某个版本（危险操作，慎用）gitreset--hardv1.0.0

三、git revert — 安全回滚

与reset不同，revert会创建一个新的 commit 来撤销指定的 commit，不会改变历史。

# 回滚最近一次 commitgitrevert HEAD# 回滚指定 commitgitrevert abc1234# 回滚多个 commitgitrevert abc1234..def5678# 回滚合并 commit（需要指定主线）gitrevert-m1<merge-commit-hash>

reset vs revert 对比

场景：已 push 到远程的 commit 有问题 git reset --hard HEAD~1 ✅ 直接回退 ❌ 改变了历史，其他人需要重新 clone ❌ 如果有其他人在基于你的代码开发，会造成灾难 git revert HEAD ✅ 创建新 commit 撤销，不改变历史 ✅ 安全，其他人可以正常 pull ❌ 历史中会多一个 "revert" commit

企业规则：已 push 的代码用 revert，未 push 的代码用 reset。

四、git rebase 深入

4.1 rebase vs merge 的本质区别

merge（合并）： * merge commit |\ | * feature commit 2 | * feature commit 1 |/ * develop commit rebase（变基）： * feature commit 2 * feature commit 1 * develop commit 2 * develop commit 1

4.2 交互式 rebase（最强大的功能）

# 修改最近 5 次 commitgitrebase-iHEAD~5# 编辑器显示：pick abc1234 feat:addlogin form pick def5678 feat:addlogin API pick ghi9012 fix: fix typoinlogin pick jkl3456 feat:addlogoutbutton pick mno7890 fix: fixlogoutbug# 命令说明：# pick = 保留这个 commit# reword = 保留但修改 commit message# edit = 保留但修改内容# squash = 合并到上一个 commit（保留 message）# fixup = 合并到上一个 commit（丢弃 message）# drop = 删除这个 commit# 示例：把 fixup 合并到对应的 feat commitpick abc1234 feat:addlogin form pick def5678 feat:addlogin API fixup ghi9012 fix: fix typoinlogin pick jkl3456 feat:addlogoutbutton fixup mno7890 fix: fixlogoutbug

4.3 rebase 的黄金法则

不要对公共分支（main/develop）执行 rebase！
不要对已经 push 到远程且别人正在使用的分支执行 rebase！

为什么？ 因为 rebase 会重写 commit hash， 如果别人基于旧的 commit 继续开发， 他们的代码和你的代码就会产生冲突。

五、git bisect — 二分查找 Bug

# 启动二分查找gitbisect start# 标记当前版本有 Buggitbisect bad# 标记一个已知好的版本gitbisect good v1.0.0# Git 会自动 checkout 中间的 commit# 测试后告诉 Git 好坏gitbisect good# 这个版本没问题gitbisect bad# 这个版本有问题# 重复几次后，Git 会找到引入 Bug 的第一个 commit# 结束后gitbisect reset

自动化 bisect

# 用脚本自动测试gitbisect start HEAD v1.0.0gitbisect runnpmtest# Git 会自动运行 npm test，根据返回值判断好坏# 0 = good, 非 0 = bad

六、git worktree — 多分支并行开发

场景：你在开发功能 A，需要紧急修 Bug，但不想 stash 当前工作。

# 在另一个目录 checkout 另一个分支gitworktreeadd../hotfix-branch hotfix/fix-bug# 现在你有两个工作目录：# 1. 原目录：feature/user-login（继续开发功能 A）# 2. ../hotfix-branch：hotfix/fix-bug（修 Bug）# 修完 Bug 后cd../hotfix-branchgitadd.gitcommit-m"fix: critical bug"gitpush origin hotfix/fix-bug# 删除 worktreegitworktree remove../hotfix-branch# 查看所有 worktreegitworktree list

七、git archive — 导出代码快照

# 导出当前分支的代码（不包含 .git 目录）gitarchive-olatest.zip HEAD# 导出指定 taggitarchive-ov1.0.0.zip v1.0.0# 导出指定目录gitarchive-osrc.zip HEAD src/

八、git clean — 清理工作区

# 查看哪些未跟踪文件会被删除（dry run）gitclean-fd--dry-run# 删除未跟踪的文件和目录gitclean-fd# 删除被 .gitignore 忽略的文件gitclean-fdx# 删除所有未跟踪的文件（危险！）gitclean-fdX

九、故障排查手册

9.1 “我的代码去哪了？”

# 查看所有操作记录gitreflog# 查看 HEAD 指向gitlog-1# 查看分支图gitlog--oneline--graph--all# 查看某个 commit 的详细信息gitshow abc1234

9.2 “我误删了文件/分支”

# 恢复删除的文件gitcheckout HEAD --<file># 或者gitrestore<file># 恢复删除的分支gitreflog# 找到最后的 commitgitcheckout-b<branch-name><commit-hash>

9.3 “我 push 了错误的代码”

# 方案1：撤回 push（需要 force push，危险）gitreset--hardHEAD~1gitpush --force-with-lease# 方案2：revert（安全，推荐）gitrevert HEADgitpush

9.4 “rebase 冲突太多了”

# 放弃本次 rebasegitrebase--abort# 或者用 merge 代替gitmerge origin/develop

9.5 “git pull 有冲突”

# 方案1：先 rebase 再 pullgitpull--rebaseorigin main# 方案2：先 stash 再 pullgitstashgitpull origin maingitstash pop# 方案3：放弃本地修改gitreset--hardorigin/main

9.6 “detached HEAD 是什么？”

# 你 checkout 了一个 commit 而不是分支gitcheckout abc1234# 提示：You are in 'detached HEAD' state.# 解决：创建一个新分支gitcheckout-btemp-branch# 或者回到之前的分支gitcheckout main

9.7 “大文件不小心提交了”

# 从 Git 历史中彻底删除大文件# 安装 git-filter-repopipinstallgit-filter-repo# 删除指定文件的所有历史gitfilter-repo --invert-paths--pathlarge-file.zip# 或者用 BFG Repo-Cleanerjava-jarbfg.jar --strip-blobs-bigger-than 10M repo.git

十、Git 配置速查

# ===== 查看配置 =====gitconfig--list# 所有配置gitconfig--global--list# 全局配置gitconfig--local--list# 仓库配置# ===== 设置配置 =====gitconfig--global<key><value># 全局gitconfig--local<key><value># 仓库级# ===== 删除配置 =====gitconfig--global--unset<key>gitconfig--local--unset<key># ===== 常用配置项 =====core.autocrlf# 换行符处理core.editor# 默认编辑器pull.rebase# pull 时是否 rebasepush.default# push 默认行为init.defaultBranch# 默认分支名

十一、Git 别名配置

# 常用别名gitconfig--globalalias.st statusgitconfig--globalalias.co checkoutgitconfig--globalalias.br branchgitconfig--globalalias.cm commitgitconfig--globalalias.lg"log --oneline --graph --all --decorate"gitconfig--globalalias.last"log -1 --stat"gitconfig--globalalias.unstage"reset HEAD --"gitconfig--globalalias.amend"commit --amend --no-edit"gitconfig--globalalias.wip"!git add -A && git commit -m 'WIP: work in progress'"gitconfig--globalalias.undo"reset --soft HEAD~1"