外观
Git 原理与常用命令实战:从快照、分支到故障恢复
摘要
为什么 add 后继续修改,commit 却没有提交最新内容?为什么切换分支不需要复制一份项目,变基却会改变提交 ID?理解这些问题,要先分清文件当前的状态、准备提交的状态和已经保存的历史。本文从这个基本模型出发,解释对象存储、分支、合并与撤销,再通过独立的小仓库实验和命令速查,将模型用于日常协作与发布排障。
阅读指引
- 定位:面向系统学习后端开发的程序员,先建立基本模型,再解释命令改变了什么。不要求先记住几十个参数。
- 基线:示例以 Git 2.47.1 验证,不作为最新版本清单;
switch、restore要求 Git 2.23+。支持范围以本机git --version和git help <command>为准。 - 示例环境:命令块使用 Bash,可在 Linux、macOS 或 Windows Git Bash 执行。PowerShell 的变量、引号、重定向和循环不同,不要原样复制 Bash 脚本。
- 安全约定:完整实验都在新建的临时仓库中进行。标为“命令速查”的片段是按问题选用的示意,不是要顺序执行的脚本。涉及共享历史、删除文件和远端写入时先确认范围。
- 学习结果:能说清一次提交如何生成、一次合并如何判断、一次撤销影响哪些位置;能从版本证据定位发布问题,而不是把“Git 回滚”当成完整的线上回滚。
1. 先有全景:Git 管理的是状态与历史
Git 是分布式版本控制系统(Distributed Version Control System):普通完整克隆通常拥有本地对象和历史,无需每次询问服务端就能比较、提交和切分支。浅克隆、部分克隆会减少本地持有的数据,后文单独说明。
按章节顺序阅读,可以先理解一次提交如何保存,再理解分支如何合并和历史如何恢复。赶着解决问题时,可先查第 6 节命令表,再回到对应原理章节核对前提。
先认识四个位置:
| 位置 | 英文与含义 | 你主要在这里做什么 |
|---|---|---|
| 工作区 | Working Tree,当前检出的文件 | 编辑、运行、测试代码 |
| 暂存区 | Index / Staging Area,下次提交的候选树状态 | 选择文件或片段,组织一次提交 |
| 本地对象与引用 | Repository,通常由 .git 管理 | 存放提交、文件对象、分支等历史信息 |
| 远端仓库 | Remote Repository,由路径或 URL 指定 | 交换对象并更新允许写入的引用 |
快照是某一时刻的文件内容与目录结构;提交则在快照之外记录作者、说明和父提交等历史信息。引用(ref)是为对象保存的可更新名称,分支就是一种指向提交的引用。可以先把一次普通提交理解为:编辑工作区,用 add 选定要保存的内容,再用 commit 将暂存区的状态写入历史。提交之后,未暂存的修改仍留在工作区。
图表将在阅读到此处时加载…
图里的箭头不是每次复制整个仓库。fetch 下载需要的对象并更新适用远端跟踪引用;push 尝试更新远端指定引用,不会把工作区未提交内容顺手传上去。
1.1 三种差异必须先分清
HEAD 表示当前检出位置,通常指向当前分支,分支再指向一个 commit(提交对象)。“检出”就是把选定版本的文件呈现在工作区。已有提交时,HEAD 对应的快照可以作为比较基准;暂存区是下一次准备保存的状态,工作区是正在编辑的状态。因此,三者之间的差异回答的是不同问题。
| 命令 | 比较对象 | 典型用途 |
|---|---|---|
git diff | 工作区与暂存区 | 哪些修改还没有暂存 |
git diff --cached | 暂存区与 HEAD | 下一次提交准备包含什么 |
git diff HEAD | 已跟踪文件的工作区与 HEAD | 相对当前提交的整体文件差异 |
git status --short | 索引与工作区的状态汇总 | 快速区分暂存、未暂存和未跟踪 |
未跟踪文件不会自动出现在普通 git diff 中。短状态的两列分别表示索引与工作区状态;?? 表示未跟踪,MM 表示同一文件既有已暂存修改又有后续工作区修改。
1.2 最小实验:add 不是“订阅后续修改”
下面是独立的完整 Bash 实验,不连接真实远端:
bash
# 新建隔离目录,避免在业务仓库练习
LAB=$(mktemp -d)
cd "$LAB"
git init -b main
git config user.name "Git Learner"
git config user.email "learner@example.invalid"
git config core.autocrlf false
# 第一版提交
printf 'version=1\n' > app.txt
git add -- app.txt
git commit -m "feat: add first version"
# 暂存第二版,随后继续编辑为第三版
printf 'version=2\n' > app.txt
git add -- app.txt
printf 'version=3\n' > app.txt
# 分别看工作区、暂存区和 HEAD
git status --short
git diff -- app.txt
git diff --cached -- app.txt
git show :app.txt
git show HEAD:app.txt
# 提交的是已暂存的第二版,不是工作区第三版
git commit -m "feat: stage second version"
git show HEAD:app.txt
cat app.txt关键预期:git show :app.txt 是 version=2,原 HEAD 是 version=1;第二次提交后 HEAD 是第二版,工作区仍是第三版。commit ID、临时路径和输出措辞不要求一致。
反例:add 之后继续修改,却以为直接 commit 会提交最新版。正例:提交前检查 git diff --cached,需要时再次 add。暂存区记录的是 add 时的内容状态,不是文件名的永久待提交标记。
2. 底层原理:快照、对象与内容寻址
2.1 Git 为什么不像一叠补丁
Git 的提交在逻辑上描述文件树快照,而不是“第 N 版只保存相对第 N-1 版的补丁”。相同内容可以复用对象;物理打包时还可以进行差分压缩。这两个层次必须区分:逻辑上是快照模型,存储上允许压缩和去重。
Git 将文件内容、目录结构和提交信息分别存成对象,再通过对象标识连接它们。内容寻址(Content-addressed Storage)指按对象内容计算标识,再用标识访问对象;内容相同的对象可以复用,不必为每次提交重新保存一份。常见对象如下:
| 对象 | 存储什么 | 不存储什么 |
|---|---|---|
| blob | 文件内容,经过适用的工作区到仓库转换 | 文件名不在 blob 内,空目录也不是 blob |
| tree | 名称、模式(文件类型与可执行位等)与子对象 ID,描述目录结构 | 不复制所有文件的内容,也不保存全部文件系统权限 |
| commit | 根 tree、父提交、作者/提交者、消息等 | 分支名不写在 commit 对象里 |
| tag | 附注标签的目标、标签者、消息及可选签名 | lightweight tag(轻量标签)只是引用,不一定有 tag 对象 |
Git 主要记录普通文件、可执行位、符号链接、子模块引用等模式,不是完整文件系统备份:所有者、任意权限、时间戳等不能靠一次 Git 提交完整恢复。
图表将在阅读到此处时加载…
沿图中的关系,从分支可以找到提交,再从提交找到根目录树和文件内容。新建分支通常主要创建一个引用,不复制项目目录;在该分支提交后,引用指向新 commit,旧对象保持不变。切换分支仍需更新工作区中有差异的文件,因此创建分支的成本与检出文件的成本要分开看。
2.2 哈希到底算了什么
对象 ID(OID,Object ID)由对象类型、内容长度及对象内容共同计算。在 SHA-1 仓库中可理解为:
text
SHA-1("<type> <content-length>\0" + content)长度是字节数,不是字符个数;blob 的文件名不参与其内容哈希。Git 也支持 SHA-256 对象格式,仓库格式、服务端和工具兼容性要单独检查,不能把“Git ID 永远 40 位”写成普遍规则。
commit 的父节点和元数据也参与对象内容。因此同一份代码、不同父提交或提交消息,会产生不同 commit ID;相同 tree 不代表相同提交历史。短 ID 只是本地可消歧前缀,自动化和审计尽量保留完整 ID。
哈希用于标识与完整性校验,不等于发布者身份认证。作者姓名/邮箱可以配置,验证来源还需要签名、可信公钥、服务端权限和构建供应链证据。
继续在第 1 节实验仓库查看对象:
bash
# 查看提交内容、根目录树和已提交文件 blob
git cat-file -p HEAD
git ls-tree HEAD
git rev-parse HEAD:app.txt
git cat-file -t HEAD:app.txt
git cat-file -p HEAD:app.txt
# 查看当前仓库的存储对象格式与 HEAD 指向
git rev-parse --show-object-format
git symbolic-ref HEAD
git show-ref --headscat-file -p HEAD 中能看到 tree 与 parent,文件内容通过 tree 中的条目指向 blob。不能因为提交消息没变,就推导整个 commit ID 不变。
2.3 暂存区不是“一个存补丁的文件夹”
Index(索引,也称暂存区)通常是数据文件,记录路径、模式、对象 ID 和状态等信息。add 会把选定内容按适用规则写成对象,并让索引条目指向该对象;commit 使用索引构建树,再创建提交对象并更新当前分支。这解释了第 1 节的实验:add 后继续编辑,只改变工作区,不会自动改变索引中的对象 ID。
工作区内容可能按 .gitattributes(路径属性规则)和配置进行换行转换,或经过 clean filter(写入仓库前的内容转换)。所以工作区的磁盘字节不一定与 blob 字节完全相同。Git LFS(Large File Storage,大文件存储)使用这类过滤机制:Git blob 可能保存指针文件,大文件的实际内容位于另一套存储中。
冲突时,索引还能为同一路径记录多个 stage(阶段):1 通常对应 base(共同基线),2 对应 ours(当前操作的一侧),3 对应 theirs(另一侧)。这些条目保留待比较的版本,帮助你决定最终内容;两侧的具体含义取决于操作,第 4 节会区分 merge 与 rebase。部分删除/新增冲突不具备三个完整条目。解决冲突并 add 后,该路径恢复为正常的 stage 0。
2.4 Loose object、Packfile 与垃圾回收
Loose object(松散对象)通常单独压缩存储;Packfile(打包文件)把对象集中存储,可使用 delta compression(差分压缩)。.idx 帮助按对象 ID 找到包内位置。压缩可以选择合适基对象,不代表逻辑历史变成相邻提交补丁链。
“可达”指从某个引用出发,沿提交的父关系和对象连接能够找到目标对象。对象能否保留与这种可达性相关。分支、标签及适用的 reflog(本地引用位置变化日志)记录可保留相关对象;变基、删分支或 reset 后,旧提交可能不再能从原分支找到,但未必立即消失。git gc(垃圾回收)、维护与过期策略会影响不可达对象的生命周期,因此不能承诺旧提交永久可恢复。
bash
# 只观察对象数量和包大小,不在生产仓库强制清理
git count-objects -vH
git fsck --full
# 查看引用变化记录;它是本地记录,不是远端永久审计日志
git reflog --date=iso不要手工编辑 .git/objects、删除 pack 或随意执行 git gc --prune=now 来“修复空间”。它们可能破坏恢复机会,进行中的写入和并发维护也有风险。
3. 分支、HEAD 与远端:先把引用关系画清楚
3.1 分支和 HEAD 的关系
通常状态:HEAD → refs/heads/main → commit。Detached HEAD(分离头指针)则直接检出某个提交,没有普通当前分支引用随新提交移动。
text
正常分支:HEAD → main → C
↑ 提交后 main 指向 D,D 的父为 C
分离状态:HEAD → C
↑ 新提交仍可创建,但要及时建立分支来保留它分离状态适合查看旧版本,不是仓库坏了。风险是你在该状态提交后切走,又不知道新提交在哪;正确做法是建立分支,而不是把整个工作区复制到另一个目录。
bash
# 只读检查当前状态
git branch --show-current
git status
# 切到已存在的提交查看;将 COMMIT_ID 换成实际 ID
git switch --detach COMMIT_ID
# 如果决定继续开发,先建立分支保留当前位置
git switch -c fix/from-old-versionHEAD~2 通常沿第一父链向前两步;HEAD^2 是 HEAD 的第二父提交,不是“向前两个版本”。普通提交没有第二父节点,多父关系出现在合并提交等场景。
3.2 origin/main 不等于远端当前状态
origin 只是远端配置名,origin/main 是本地的 remote-tracking ref(远端跟踪引用)。它表示上次相应更新观察到的状态,不是每次读取都请求服务端。
bash
# 查看 URL、跟踪关系和本地已知状态
git remote -v
git branch -vv
git remote show origin
# 获取对象并更新适用跟踪引用;清理远端已删除的跟踪分支
git fetch --prune origin
# 直接查看服务端报告的引用,仍然只是此刻的观察
git ls-remote --heads originUpstream(上游跟踪配置)决定某个本地分支默认与哪个远端分支关联,不表示本地和远端内容总是相同。push -u 常用来建立关联。
3.3 fetch、pull、push 的真正边界
| 命令 | 主要动作 | 不会自动做什么 |
|---|---|---|
| fetch | 取回需要的对象,更新适用跟踪引用等 | 不自动把当前业务分支合并到远端最新状态 |
| pull | fetch 后按参数/配置进行 merge 或 rebase 等整合 | 不保证永远只做快进,也不保证无冲突 |
| push | 请求服务端更新指定引用并传输需要的对象 | 不上传未提交文件,不保证服务端接受更新 |
Fast-forward(快进)指旧 tip(分支末端)是新 tip 的祖先,更新引用即可,不需要新合并提交。非快进推送通常被拒绝,避免无意丢掉远端历史;服务端保护规则、hooks 和权限还可以拒绝其他更新。
bash
# 只允许当前拉取做快进;分叉时停下来让你决定
git pull --ff-only
# 看双方各自独有的提交,先 fetch 再解释结果
git log --left-right --graph --oneline HEAD...origin/main
# 明确建立跟踪关系并推送,不隐式推送所有分支
git push -u origin maingit log A..B 列出从 B 沿父关系能找到、但从 A 找不到的提交;git log A...B 列出只属于一侧历史的提交,不包含双方共有的提交。注意 diff 的语义不同:git diff A..B 基本比较两个端点,git diff A...B 通常比较共同基线到 B 的差异,不能把三个点在所有命令里理解为同一件事。
4. Merge、Rebase 与冲突:不是只会选 ours/theirs
4.1 三方合并如何判断
只比较两个分支的最终文件,无法判断哪一侧改过内容。Three-way merge(三方合并)因此引入共同祖先 base 作为基线,再比较当前侧 ours、待合并侧 theirs 分别做了什么。若一侧修改、另一侧未改,可以保留修改;双方在可合并的不同位置改动可能自动合并;同一区域不兼容修改可能冲突。共同祖先是沿双方父提交关系都能找到的历史提交;复杂历史可能有多个最佳共同祖先,合并时的基线处理也更复杂。
text
C──D main(ours)
/
A──B
\
E──F feature(theirs)
merge 产生 M:父节点包含 D、F,文件树是合并结果Git 自动合并成功,只表示工具在内容规则上能得到结果,不代表业务正确。两个分支各自在不同文件修改金额单位、配置名或 API 契约,也可能没有文本冲突但造成运行故障。
冲突标记的内容是待你决策的证据:
text
<<<<<<< HEAD
当前侧内容
=======
待合并侧内容
>>>>>>> feature反例:删除所有标记,整段选 ours,不看需求和测试。正例:比较基线和两侧意图,编辑正确结果,再 add、完成合并并跑关联测试。
4.2 完整实验:制造并解决一处冲突
本实验独立于第 1 节,可整块在 Git Bash 执行:
bash
# 创建新的隔离仓库
MERGE_LAB=$(mktemp -d)
cd "$MERGE_LAB"
git init -b main
git config user.name "Git Learner"
git config user.email "learner@example.invalid"
git config core.autocrlf false
printf 'timeout=10\n' > config.txt
git add -- config.txt
git commit -m "chore: initial timeout"
# feature 修改同一行
git switch -c feature
printf 'timeout=20\n' > config.txt
git commit -am "feat: increase timeout"
# main 也修改同一行,形成分叉
git switch main
printf 'timeout=30\n' > config.txt
git commit -am "fix: adjust timeout"
# 这里应报告冲突;不要把失败状态当作脚本意外
if git merge feature; then
echo "Expected a conflict but merge succeeded"
exit 1
fi
# 查看索引的共同基线与两侧内容
git ls-files -u
git show :1:config.txt
git show :2:config.txt
git show :3:config.txt
# 假设需求评审决定最终使用 25;这是教学决策,不是通用合并规则
printf 'timeout=25\n' > config.txt
git add -- config.txt
git diff --cached --check
git commit -m "merge: reconcile timeout requirements"
git rev-list --parents -n 1 HEAD预期三阶段内容为 10、30、20,最终为 25,最终提交有两个父节点。若决定不继续这次合并,可在尚未完成时执行 git merge --abort;开始前未提交修改可能让恢复更复杂,因此先建立安全基线。
4.3 Rebase 为什么改 commit ID
Rebase(变基)通常把选定提交的改动重新应用到新基线,生成新提交。“重放”就是取出一个提交相对其父提交的改动,在新的历史位置重新应用。父关系变了,commit 对象内容通常就变了,ID 随之改变;因此变基不只是移动分支引用。
text
变基前:A──B──C main
\
D──E feature
变基后:A──B──C──D'──E' feature实际变基可能跳过已有等价改动、处理空提交或按配置重建合并,因此不保证每个原提交都一对一留下副本。默认行为也不等于保留所有合并结构。
bash
# 先保证工作区干净,获取实际基线,再切换待变基的个人分支
git fetch origin
git switch feature
git branch backup/feature-before-rebase
git rebase origin/main
# 发生冲突:编辑正确结果后暂存,再继续
git add -- resolved-file.txt
git rebase --continue
# 不继续时回到此次变基前;skip 会丢掉当前正在重放的提交改动
git rebase --abort以上是按状态选用的流程,不要在一次成功 rebase 后继续执行不存在的 continue/abort。交互变基 git rebase -i BASE 可重排、合并、编辑或删除选定提交;BASE 本身通常不属于重放列表。
变基时 ours/theirs 容易反直觉:ours 通常是正在构建的新基线一侧,theirs 是当前重放提交一侧,不能机械套用 merge 时“我自己写的就是 ours”。--skip 也不是忽略冲突继续保留全部改动。
4.4 Merge、Rebase、Cherry-pick 怎么选
| 目标 | 常见选择 | 取舍 |
|---|---|---|
| 合并共享开发分支并保留分叉历史 | merge | 合并记录清楚;需理解多父提交 |
| 整理尚未共享的个人提交 | rebase | 更线性,但会重写选定提交 |
| 把某个修复移植到维护分支 | cherry-pick | 重放指定改动,通常生成新 ID;需验证依赖与重复应用 |
| 多个提交合为一次候选变更,不保留父关系 | merge --squash | 产生待提交内容,不创建普通多父 merge 关系 |
merge --no-ff 可要求保留合并节点,merge --ff-only 只接受快进。没有“rebase 永远比 merge 高级”的规则,应该按审计、协作和分支生命周期选择。
5. 撤销与恢复:先问你要改哪一个位置
5.1 restore、reset、revert 一张表看清
先区分两类目标:修改文件状态,还是撤销历史中的变更。restore 主要恢复索引或工作区中的文件;提交级 reset 改变当前历史位置,并按模式更新索引和工作区;revert 则在当前位置创建反向变更提交。共享历史通常选择 revert,因为其他人仍能沿原有提交关系理解后续变化。
| 目标 | 命令 | 影响与风险 |
|---|---|---|
| 取消某文件暂存,保留工作区内容 | git restore --staged -- file | 默认从 HEAD 恢复索引,不移动分支 |
| 丢弃某文件未暂存修改 | git restore -- file | 默认从索引恢复工作区,会覆盖适用修改 |
| 用指定提交恢复文件到工作区 | git restore --source=COMMIT -- file | 不自动暂存;可能移除该来源中不存在的已跟踪路径 |
| 撤回最近提交,保留暂存状态 | git reset --soft HEAD~1 | 移动当前分支/HEAD,索引和工作区不改 |
| 撤回最近提交,改动变为未暂存 | git reset --mixed HEAD~1 | 更新索引,不覆盖工作区;默认 reset 模式为 mixed |
| 回到某提交并覆盖索引与工作区 | git reset --hard COMMIT | 破坏性操作;未提交修改不保证可恢复,阻挡写入的未跟踪路径也可能被删除 |
| 在共享历史中反向撤销一个提交 | git revert COMMIT | 新建反向变更提交,不删除旧历史;可冲突 |
带路径的 git reset COMMIT -- file 主要更新索引,不是把分支重置到那个提交。reset 的提交级和路径级形式不能混为一谈。
反例:生产维护分支出了错误,先 reset --hard 再强推,破坏同事已使用的历史。正例:确认目标提交与部署范围,在共享分支创建 revert,经测试和发布流程上线。
5.2 恢复误删提交:先保留旧 tip
bash
# 重置/变基之前保留引用;名称应唯一,避免覆盖已有备份分支
git branch backup/before-change
# 已经误操作:找本地历史位置,但不要只盲用 HEAD@{1}
git reflog --date=iso
git show --stat LOST_COMMIT
# 先创建恢复分支,检查结果,而不是立即覆盖当前分支
git branch rescue/lost-work LOST_COMMIT
git log --oneline rescue/lost-work -n 5Reflog(引用日志)记录本地引用过去的位置,不会通过普通 push/fetch 完整同步,也有过期条件。它通常可以找回尚未被清理的提交,不能承诺恢复从未写成对象的工作区修改。add 过的 blob 有时还能查找,但不一定有文件名和完整目录上下文,不应当成可靠备份方案。
ORIG_HEAD 是某些操作保存的旧位置,也可能被后续操作覆盖;不是长期不变的保险箱。最稳妥的是在风险操作前保留明确引用和工作区备份。
5.3 revert 合并提交为什么要 -m
合并提交有多个父节点,revert 必须明确相对哪个父节点反向撤销。git revert -m 1 MERGE_COMMIT 中的 1 表示第一父节点作为 mainline(主线基准),不是“只撤销第一个提交”。先用 git show --no-patch --pretty=raw MERGE_COMMIT 核对父关系。
revert merge 不会抹掉“历史上已经合并”的祖先关系。以后再次合并同一条分支,已合并过的旧提交不一定重新引入其内容;可能需要 revert 那次 revert 或组织新提交。不能把它当成“恢复到合并之前,所以以后 merge 会从头再来”。
6. 常用命令速查:按任务找,不按字母背
下面覆盖日常开发、评审、发布和排障中的常见命令,不穷举 Git 全部底层命令和每个选项。大写占位符如 COMMIT、PATH、URL 必须替换;危险项不要在真实仓库试着运行。
6.1 配置、建库与检出
bash
# 确认版本与配置来自哪一层;作者身份不等于远端认证身份
git --version
git config --show-origin --list
git config --local user.name "Your Name"
git config --local user.email "you@example.com"
git config --global init.defaultBranch main
# 建库、完整克隆;URL 替换为授权仓库地址
git init -b main
git clone URL
git clone --branch main URL project-dir
# 分支列表、创建、切换与重命名
git branch -a
git branch -vv
git switch -c feature/order
git switch main
git branch -m old-name new-name
git branch -d merged-branch
# 兼容旧用法;checkout 同时承担切分支与恢复文件,易混淆
git checkout main
git checkout -b feature/legacybranch -d 有合并关系检查,但不等于服务器没有依赖该分支;branch -D 跳过保护,使用前先保留 tip。克隆时 hooks、本地全局配置和全部远端权限不会都从仓库自动继承。
6.2 检查、暂存与提交
bash
# 看状态与差异;-- 分隔选项/修订和路径,避免路径歧义
git status
git status --short --branch
git diff -- PATH
git diff --cached -- PATH
git diff --stat
git diff --check
# 暂存指定文件、交互选择片段、暂存整个当前目录的变化
git add -- PATH
git add -p
git add -A -- .
# 提交索引;-a 自动暂存已跟踪文件的适用修改/删除,不包含新文件
git commit -m "fix: describe the reason"
git commit -am "fix: update tracked files"
# 修改最近提交,会重写该提交;已共享历史要先协商
git commit --amend
git commit --amend --no-edit
# 移动/删除已跟踪文件,或仅从索引删除,保留本地文件
git mv old.txt new.txt
git rm -- PATH
git rm --cached -- PATHGit 没有为 git mv 永久保存一个“重命名事件对象”;diff/log 的重命名识别主要是基于内容相似性等规则推断。拆分和组织提交时优先让每次变更有可解释的意图,而不是机械地按文件类型分组。
6.3 查历史与评审
bash
# 图形化文本历史、单提交和文件内容
git log --graph --decorate --oneline --all
git log -p -- PATH
git log --follow -- PATH
git show --stat COMMIT
git show COMMIT:PATH
# 按字符串数量变化或补丁行正则搜索引入点
git log -S 'old_config_key' -- PATH
git log -G 'timeout.*=' -- PATH
# 查行归属;它不是业务责任或原创作者的完整证明
git blame -L 10,30 -- PATH
# 找共同祖先、确认祖先关系;is-ancestor 用退出码表达结果
git merge-base main feature
git merge-base --is-ancestor COMMIT main
# 查看引用、规范化 ID、检查操作是否位于仓库
git show-ref
git rev-parse HEAD
git rev-parse --show-toplevel--follow 主要服务单文件历史的重命名跟踪,有边界,不代表总能恢复所有复制/拆分来源。blame 标注的是某种历史归因结果,格式化、移动和批量重写都会影响它。
6.4 整合与远端协作
bash
# 远端配置与刷新
git remote -v
git remote add origin URL
git remote set-url origin URL
git fetch --prune origin
# 明确选择整合策略
git pull --ff-only
git merge --no-ff feature
git rebase origin/main
git rebase -i BASE
git cherry-pick COMMIT
# 冲突时按当前操作选继续/中止,不能混用
git merge --abort
git rebase --continue
git rebase --abort
git cherry-pick --continue
git cherry-pick --abort
git revert --continue
git revert --abort
# 精确推送;删除远端分支是远端写操作,先确认协作方
git push -u origin feature
git push origin local-branch:remote-branch
git push origin --delete obsolete-branch6.5 撤销与恢复
撤销与恢复命令集中在第 5 节。下面补一组按目标选用的示例,不要顺序执行;尤其 hard reset 和 clean 不是日常“同步最新代码”的步骤:
bash
# 取消暂存但保留工作区;交互模式可以仅恢复指定片段
git restore --staged -- PATH
git restore -p -- PATH
# 从指定版本恢复文件;同时恢复索引/工作区前先保存当前修改
git restore --source=COMMIT -- PATH
git restore --source=COMMIT --staged --worktree -- PATH
# 整个提交层级的撤回:只用于你已确认可重写的历史
git reset --soft HEAD~1
git reset --mixed HEAD~1
# 共享历史优先用反向提交;先确认该提交的变更与依赖
git revert COMMIT
# 强制覆盖工作区,仅在明确可丢弃、已备份的范围使用
# git reset --hard COMMIT6.6 临时保存、标签与多工作区
Stash(临时保存)用于收起尚未提交的工作,方便暂时切换任务;标签为特定对象提供名称,常用于标记发布版本;worktree(关联工作区)让同一仓库拥有多个工作目录。下面按需要选用,stash 的应用、弹出和删除是不同选择,不是一条连续流程。
bash
# 默认 stash 不包括未跟踪文件;-u 加入未跟踪文件,不包括被忽略文件
git stash push -u -m "wip before investigation"
git stash list
git stash show -p 'stash@{0}'
git stash apply 'stash@{0}'
git stash pop 'stash@{0}'
# apply 不自动删记录;pop 成功时通常移除,冲突时需检查保留状态
git stash drop 'stash@{0}'
# 附注标签、查看与精确推送;签名标签还要求本机签名配置
git tag -a v1.2.0 -m "Release v1.2.0"
git show v1.2.0
git push origin v1.2.0
git tag -s v1.2.0-signed -m "Signed release"
git verify-tag v1.2.0-signed
# Worktree:一个仓库对象库关联多个工作目录,方便并行维护
git worktree add ../project-hotfix -b hotfix main
git worktree list
git worktree remove ../project-hotfixstash -a 还会纳入忽略文件,可能含大产物或秘密。stash 不是远端备份;应用冲突时没有通用 stash --abort,先检查状态和保存的数据,再决定恢复方式。worktree 共享对象和适用引用,但各自有 HEAD、索引和工作区状态;普通情况下不能在多个 worktree 同时检出同一分支。
6.7 忽略、子模块、打包与底层观察
bash
# 找忽略规则与已跟踪条目
git check-ignore -v -- PATH
git ls-files -- PATH
git ls-files -u
# 删除未跟踪文件前先只预览;-x 会包括被忽略的产物和可能的秘密
git clean -nd
# 确认范围后才执行:git clean -fd -- disposable-dir/
# 克隆/初始化子模块;它们是独立仓库,父仓库记录所选提交
git clone --recurse-submodules URL
git submodule update --init --recursive
git submodule status
# 导出某版本的文件树,不包含 Git 历史;bundle 是对象/引用交换包
git archive --format=zip --output=release.zip TAG
git bundle create backup.bundle --all
git bundle verify backup.bundle
# 调试对象与仓库一致性
git cat-file -p COMMIT
git ls-tree COMMIT
git count-objects -vH
git fsck --full
git reflog --date=isobundle 不包括未提交工作区、完整配置、hooks、全部 reflog、子模块仓库及 LFS 实体等,不能当整个开发环境备份。底层命令如 hash-object、write-tree、commit-tree、update-ref 服务对象或引用操作;可以学习其原理,但不要手工修改引用来代替正常协作流程。
7. 容易踩的坑:先用反例校正直觉
7.1 .gitignore 不会让已提交的秘密消失
.gitignore 主要影响未跟踪路径的默认纳入行为,不自动停止跟踪已有文件,也不擦除旧提交。
反例:把 .env 加进 ignore,再推一次,就以为泄露的 token 安全了。
正例:立即吊销/轮换凭证,核对使用记录与影响面;再按协作流程停止跟踪和清理历史。历史清理需要协调远端引用、保护策略、镜像、PR 引用、同事克隆等,不能承诺一条命令删除所有外部副本。
bash
# 观察文件是否已跟踪、规则来自哪里
git ls-files -- .env
git check-ignore -v --no-index -- .env
# 确认后停止跟踪但保留本地文件;仍需提交对应变更
git rm --cached -- .env7.2 force-with-lease 不是“随便强推的保险”
普通 --force 可能覆盖远端新增历史;--force-with-lease 增加预期引用值检查。默认预期常来自本地跟踪引用,如果后台 fetch 更新了它,保护边界可能与你审阅的历史不一致。
确实需要重写已共享分支时,先协商并记录你审阅过的远端完整 OID,再指定 lease:
bash
# EXPECTED_OID 必须是你实际审阅确认过的远端旧 tip,不是随手猜一个 ID
# 以下是显式条件写入,仍然会重写共享历史
git push --force-with-lease=refs/heads/feature:EXPECTED_OID origin HEAD:refs/heads/featurelease 类似对远端引用的条件更新:当前值等于预期才允许请求继续。但它不会证明新历史包含全部业务修复,也不会替你恢复其他分支、外部构建和协作方状态;服务端仍可拒绝。
7.3 换行、大小写与“所有文件都变了”
LF 是单个换行字符,CRLF 是回车加换行的组合。换行格式、.gitattributes、core.autocrlf 与过滤器会影响工作区与仓库存储的转换;如果整份文件的换行都变了,即使可见文字没变,也可能出现大量差异。先检查差异原因,再决定是否调整规则,避免全局配置影响其他仓库。
bash
# 检查指定文件的换行与适用属性
git ls-files --eol -- PATH
git check-attr text eol filter -- PATH
git config --show-origin --get core.autocrlf
# 在独立提交中规范文本换行,先评审影响范围
# .gitattributes 例:*.sh text eol=lf
# 修改规则后可评审:git add --renormalize -- .大小写不敏感文件系统上,只改大小写的名称可能不按预期呈现。使用中间名、检查 git diff --cached --summary,并在目标 Linux 环境验证实际路径。符号链接、可执行位和文件名编码也不能只靠本地 IDE 显示判断。
7.4 浅克隆和子模块让“历史完整”不再成立
clone --depth 1 是浅克隆(Shallow Clone),只取有限历史;clone --filter=blob:none 是部分克隆(Partial Clone)的常见形式,某些内容按需获取。两者减少数据的方式不同。
bash
# 判断浅克隆,必要时获取更多历史;远端必须允许且有相应历史
git rev-parse --is-shallow-repository
git fetch --deepen=100 origin
git fetch --unshallow origin缺历史会影响 merge-base、blame、bisect 和版本描述;缺 blob 时离线查看内容可能失败。父仓库更新子模块提交,不代表子模块工作区已经自动检出那个版本,构建前核对子模块状态。
7.5 Hooks、身份与认证不要混为一谈
Hook(钩子)是在指定阶段运行的脚本。客户端 hook 可以阻止一次本地提交,也可能被绕过;服务端校验和分支保护应承担共享规则,不能把本地 hook 当完整安全边界。
user.name/email 是提交元数据,远端 HTTPS/SSH 身份来自认证机制。推送 403 或 SSH 权限失败时,应检查 URL、凭证、仓库权限和保护策略,不能通过改作者邮箱解决。
不要把 token 写进远端 URL、shell 历史或文章示例。仓库不可信时,还要评估 hooks 配置、过滤器、子模块来源和构建脚本执行风险;克隆与执行项目代码不是同一种风险。
8. 定位发布问题:从线上版本证据回到 Git
8.1 Git 中的代码不是运行产物的完整证明
源码要经过依赖解析、编译和打包才能成为运行产物,运行时还会读取配置和外部数据。因此,线上故障先确认实例、镜像/包 digest(内容摘要)、完整 commit OID、构建参数、依赖锁文件、配置及发布时间。依赖锁文件记录构建所选的依赖版本;脏工作区指相对已提交状态仍有本地变化的工作区。分支名和可移动标签不足以唯一标识代码;只知道“部署来自 main”,无法确定实际发布版本。
bash
# 构建机记录精确版本与脏工作区;还要保存产物摘要及构建信息
git rev-parse HEAD
git status --porcelain
git describe --tags --always --dirty
# 比较两个已确认的发布提交,查看改动范围与文件内容
git diff --stat OLD_RELEASE NEW_RELEASE
git diff OLD_RELEASE NEW_RELEASE -- PATH
git log --oneline OLD_RELEASE..NEW_RELEASEdescribe 是便于人读的版本描述,不保证所有未跟踪文件或外部依赖都被编码进字符串。没有脏标记也不证明构建是可复现、镜像未被替换。
结合 JVM 故障排查对齐现场版本、时间窗口与运行证据;涉及 JDK/依赖切换时,参照 版本迁移与回滚区分代码、运行时和外部状态。
8.2 Bisect:二分定位第一个坏提交
git bisect 在给定好/坏提交之间,选择候选提交供测试,逐步缩小范围。效率来自缩小候选集合,不是只按提交时间取中间点;历史是提交图而非简单数组。
前提是有可靠判定:相同测试环境下某提交好还是坏,并且要检查故障是否符合定位所需的变化规律。如果问题曾出现、修复、又重新出现,就不是简单的“某次提交之后一直坏”的单调变化,需额外检查。依赖变化、外部配置、随机失败和不可构建历史也会使定位结果失真。
下面是完整本地实验,测试脚本放在仓库外,避免检出旧提交时脚本消失:
bash
# 建立七个提交,第五个开始把计算结果改错
BISECT_LAB=$(mktemp -d)
cd "$BISECT_LAB"
git init -b main
git config user.name "Git Learner"
git config user.email "learner@example.invalid"
git config core.autocrlf false
for version in 1 2 3 4 5 6 7; do
printf 'revision=%s\n' "$version" > revision.txt
if [ "$version" -lt 5 ]; then
printf 'printf "42\\n"\n' > app.sh
else
printf 'printf "41\\n"\n' > app.sh
fi
git add -- app.sh revision.txt
git commit -m "version $version"
done
# 仓库外测试脚本:0 为 good,1 为 bad;125 可表达该提交无法测试
TEST_SCRIPT=$(mktemp)
printf '%s\n' '[ "$(bash app.sh)" = "42" ]' > "$TEST_SCRIPT"
GOOD=$(git rev-list --max-parents=0 HEAD)
git bisect start HEAD "$GOOD"
git bisect run bash "$TEST_SCRIPT"
git bisect log
git bisect reset预期定位消息为 version 5 的首个坏提交。bisect run 退出码 0 表示好,1~127 中除 125 外通常表示坏,125 表示跳过;执行失败的退出码也可能被当坏,所以“缺编译器”不能盲当业务坏版本。跳过太多提交可能无法唯一定位。
8.3 常见故障分诊
| 现象 | 先查什么 | 不要直接做什么 |
|---|---|---|
| 推送被 non-fast-forward 拒绝 | fetch 后检查分叉与同事新增提交 | 直接加 --force |
| checkout/switch 被本地修改阻止 | status、diff,选择提交/stash/备份 | 随手 hard reset 清现场 |
| 文件“明明改了”却没进提交 | 索引内容、ignore、未跟踪、后续编辑 | 认定 Git 丢文件 |
| 线上代码与预期不同 | 产物摘要、OID、脏构建、配置、子模块/LFS | 只比较分支名 |
| 误删分支或变基后找不到提交 | reflog、旧 tip、恢复分支 | 立即 gc/prune 清对象 |
| pull 冲突或变基卡住 | 当前操作状态、索引冲突、基线与两侧 | 混用 merge/rebase 的 continue/abort |
| 仓库对象读取异常 | 存储/网络状况、fsck、备份和健康副本 | 手工删除出错 pack 后继续提交 |
8.4 Git revert 不等于线上系统回滚
revert 创建源码层面的反向变更。数据库结构、已经发送的消息、外部订单状态、依赖版本和配置变更,不会因此自动恢复。
实际回滚需要回答:旧产物能否读取新数据?新旧实例同时运行是否兼容?已经产生的副作用如何处理?重新构建是否得到相同依赖?标签是否被改写?这些要靠发布和恢复协议,不是靠一条 Git 命令。
9. 面试问题:用模型回答,不背口诀
| 问题 | 应回答的核心 |
|---|---|
| Git 为什么切分支快 | 分支本身是引用,创建不复制目录;检出仍要更新适用文件,有 I/O 成本 |
| Git 保存差异还是快照 | 逻辑提交描述快照,blob/tree 可复用;pack 层可差分压缩,层次不同 |
| add 之后编辑再 commit 提交哪版 | 提交索引候选树;未再次 add 的工作区修改不自动纳入 |
| merge 与 rebase 的区别 | merge 表达合并父关系;rebase 重放选定改动,通常改变父关系与 ID |
| reset 与 revert 的区别 | reset 改位置及适用索引/工作区;revert 用新提交反向撤销,保留历史 |
| fetch 与 pull 的区别 | fetch 获取与更新跟踪信息;pull 还整合,具体策略依参数/配置 |
| 冲突中的 ours/theirs 是谁 | 取决于当前操作,rebase 时尤其不能只凭“我的分支”判断 |
| reflog 能恢复所有丢失代码吗 | 只能在相应记录和对象仍存在等条件下恢复;未保存工作区不能承诺 |
| .gitignore 能清除秘密吗 | 不清已有历史;先轮换凭证,再协调历史与外部副本处理 |
| force-with-lease 为什么更安全但仍有风险 | 条件检查远端引用,但预期来源、业务完整性与协作边界仍需确认 |
真正的熟练是:执行前能预测对象、引用、索引和工作区哪些会变化;执行后能验证结果;遇到不确定状态先停下看证据,而不是不断加 --force。
10. 名词解释
| 名词 | 本文中的含义 |
|---|---|
| Snapshot | 一次提交描述的文件树状态,不等于物理存储每次复制全仓库 |
| Index | 下次提交候选树的索引,也记录冲突阶段,不是简单补丁列表 |
| OID | 对象标识,格式依仓库对象哈希算法;自动化优先完整值 |
| Ref / HEAD | 指向对象的引用 / 当前检出位置的引用或指针 |
| DAG | Directed Acyclic Graph,有向无环图;提交沿父关系组成历史图 |
| Merge base | 两侧历史的共同祖先基线;复杂历史可能有多个最佳共同祖先 |
| Fast-forward | 旧 tip 是新 tip 的祖先时,直接向前更新引用 |
| Rebase | 在新基线上重放选定改动,通常创建新提交 |
| Reflog | 本地引用位置变化日志,有保留和过期边界 |
| Refspec | 描述源与目标引用映射的表达,如 local:remote |
| Packfile | 集中存储对象的包,可做差分压缩;不是逻辑补丁历史 |
| Worktree | 共享仓库对象库、拥有独立检出状态的工作目录 |
| Shallow / Partial clone | 截断历史 / 按需省略部分对象的克隆方式 |
| LFS | Git Large File Storage,Git 保存指针,载荷由其他存储机制管理 |
参考资料与后续阅读
- Git 官方参考手册:命令的目标、参数与版本边界。
- Pro Git:Git Objects、Packfiles:对象与物理存储。
- gitrevisions、git diff:修订表达式与差异范围,注意不同命令的双点/三点语义。
- git reset、git restore、git revert:撤销目标与恢复边界。
- git rebase、git merge:重放、父关系、冲突与中止行为。
- git push、git reflog、git bisect:条件更新、历史恢复与定位。
- Mermaid 快速入门:把提交关系与操作流程写成可维护图表。
示例中的确定性预期是文件内容、父关系和首个坏版本,不是耗时或固定哈希。Git 工具链小实验通过不能替代真实仓库保护规则、构建验证和发布回滚演练。