DevOps Tool · Version Control

Git
把时间线变成可回放的分支图

Git 不是「带历史记录的网盘」,而是一个内容寻址的快照数据库:每次提交都是整棵目录树的一张照片,分支只是指向某张照片的可移动指针。理解这句话,大部分命令就不再需要死记。

Linus 2005 年发起 分布式 · 每个副本都是完整仓库 SHA-1 / SHA-256 寻址 分支 = 轻量指针 离线可提交
01

本质:存的不是“改动”,而是“快照”

Snapshot, not diff

SVN 等老一代工具以文件差异为中心:每次提交记录「第 3 行加了什么」。Git 反过来——每次提交都给整个项目拍一张快照,记录当时所有文件的完整状态;没变的文件不重复存储,只保留一个指向旧对象的引用。于是「回到任意历史版本」只是换一张照片,不需要把差异一层层重放。

差异存储(SVN 式)

基础文件 + 一串补丁。取版本 v5 要把 5 个补丁依次应用,历史越长越慢;分支在服务端是目录拷贝。

快照存储(Git 式)

每个版本都是一棵完整的树对象,未变内容共享同一 blob。取任意版本都是 O(1) 定位,分支只是 41 字节的指针文件。

工作区文件 提交 = 一棵树 + 元信息 app.py style.css README.md config.yml main.go … C1 · a1b2c3 tree: 9f1… parent: — "init" C2 · d4e5f6 tree: 4ab… parent: a1b2c3 "add css" tree 4ab…(C2 的目录树) ├─ app.py → blob a1b2(未变,复用 C1) ├─ style.css → blob 77c0(新内容) └─ README.md → blob 3de9(未变,复用 C1) 提交对象 ≈ 快照 + 父提交指针

关键:内容相同的文件在对象库中只存一份,所以“每次都拍全量照片”并不会让仓库膨胀。

三个对象撑起整个 Git

●

blob

文件内容的压缩存储,不含文件名。内容相同即同一个 blob。

▤

tree

目录:记录「文件名 → blob / 子 tree」的映射,相当于一次快照的骨架。

◆

commit

指向一棵 tree,外加父提交、作者、时间、说明。历史就是 commit 串成的有向图。

为什么内容改了 ID 就全变? blob/tree/commit 的 ID 都是对其内容的哈希。子目录内容一变,tree 的哈希变;tree 一变,commit 的哈希也变——所以同一个 commit ID 永远对应完全相同的历史。
02

四个区域:一条单向流水线

Working → Index → Repo → Remote

新手最常问的「我改了代码为什么别人看不到」,答案永远落在这四个区域的边界上。Git 里每一次改动都要显式地从左边推到右边,没有任何一步会自动发生。

工作区 Working Tree 你正在编辑的文件 暂存区 Index / Staging 下一次提交的草稿 本地仓库 .git / Repository 已提交的快照历史 远程仓库 Remote GitHub / GitLab… add commit push clone / pull / fetch 把远程内容拉回本地

命令总是作用在某两个相邻区域之间:add 填暂存区,commit 落盘,push 出门。

工作区
暂存区
本地仓库
远程仓库

点「编辑文件」,看看改动停在哪个区域。

用 status 反推自己在哪一步

status 提示改动位于下一步
Untracked files工作区,从未被 Git 记录git add <file>
Changes not staged for commit工作区,已跟踪文件被改git add 或 git restore
Changes to be committed暂存区,等待提交git commit
nothing to commit, working tree clean三个区域一致可以 push 或继续干活
git add 不是“加文件”,而是“把当前内容放进快照”。 先 add 再改同一个文件,提交的是 add 那一刻的版本;需要把新改动也带上,得再 add 一次。
03

第一个仓库:从 0 到第一次提交

Init / Clone

进入项目的姿势只有两种:本地新建(init)或克隆已有(clone)。克隆不只会下载最新文件,而是把整条历史连同所有分支一起搬回本地——这是 Git 能离线工作的前提。

从零开始
# 初始化(会在当前目录生成 .git/)
git init
git branch -M main

# 配置身份(只需一次)
git config --global user.name  "Your Name"
git config --global user.email "you@example.com"

# 关联远程并首次推送
git remote add origin git@github.com:you/repo.git
git push -u origin main
克隆已有项目
# 默认克隆整个历史
git clone git@github.com:you/repo.git

# 只要最近一次提交(CI 常用)
git clone --depth=1 git@github.com:you/repo.git

# 查看当前分支与远程
git status -sb
git remote -v

日常三件套

1git status随时确认自己在哪个区域、哪些文件没被跟踪。
2git add -p按代码块挑选要提交的内容,避免把调试代码混进来。
3git commit写清“为什么改”,而不是“改了什么”——diff 已经说明了后者。
4git push把本地提交同步到远程,供他人与 CI 使用。
一次完整的首次提交shell
git status                  # 看到 hello.txt 是 untracked
git add hello.txt           # 放进暂存区
git commit -m "feat: 添加问候脚本"
git log --oneline --graph   # 确认历史
提交信息约定:feat: 新功能、fix: 修缺陷、refactor: 重构、docs: 文档、chore: 杂务。团队统一前缀后,git log 本身就是一份变更日志。
04

分支:41 字节的指针,不是目录拷贝

Branch = Pointer

创建分支在 Git 里便宜到几乎免费:它只是 .git/refs/heads/ 下一个写着 commit ID 的文本文件。所以「一个功能一个分支」不会带来任何存储或性能负担,反而让主线的历史保持干净。

C1 C2 C3 C5 F1 F2 feature 指针 → F2 main → C5 HEAD 跟随当前分支

切分支 = 把 HEAD 指向另一个指针;提交 = 新节点接到 HEAD 后面,并把当前分支指针前移一格。

⎇

创建 / 切换

git switch -c feat/login
等价于旧写法 checkout -b,语义更清楚。

⇄

删除已合并分支

git branch -d feat/login
指针删掉即可,提交对象仍被其他引用保护。

⌖

查看分支拓扑

git log --graph --all --oneline
比只看当前分支更能发现分叉点。

Detached HEAD:直接 git checkout <commit-id> 会让 HEAD 脱离任何分支。此时提交的节点没有分支指向,切走后很容易「丢失」——用 git switch -c rescue 给它接一个分支即可救回。
05

合并 vs 变基:两种整理历史的方式

Merge / Rebase

两条分支各自向前走之后,要把工作合到一起,有两种做法:merge 保留分叉并生成一个合并提交;rebase 把你的提交「摘下来」重新接到对方最新提交之后,得到一条直线。

C1 C2 C3 C6 F1 F2 C6 是合并提交(两个父节点) feature 分叉被完整保留

merge 的代价:历史真实但会分叉;好处是任何时刻都没有改写已有提交,最安全。

维度mergerebase
历史形态保留分叉,有合并提交一条直线,没有合并提交
提交 ID不变全部重算
冲突处理一次性解决可能每个提交都要解决一次
适用场景合入主干、公共分支本地整理、拉取上游更新
两条分支合流的两种写法shell
# A. 合并(在 main 上把 feature 合进来)
git switch main
git merge --no-ff feature   # 强制留下合并节点,便于回溯

# B. 变基(在 feature 上追平 main)
git switch feature
git rebase main
# 若出现冲突:解决 → git add → git rebase --continue
# 想反悔:git rebase --abort
黄金法则:不要对已经推送到共享分支的提交做 rebase。别人基于那些提交在工作,你改写 ID 后他们本地会分裂成两份历史,只能靠强推来对齐。
06

读懂提交历史:log 是一张图

Reading the Graph

git log 默认按时间倒序平铺,容易误以为历史是线性的。加上 --graph 才会露出真实结构:分叉、合并、以及每个分支当前指在哪。

git log --oneline --graph --all --decorateoutput
*   9c1f4a2 (HEAD -> main) Merge branch 'feature/login'
|\
| * 4d77b10 (feature/login) fix: 登录态过期处理
| * a30e9c5 feat: 增加记住我
* | 7be2210 chore: 升级依赖
|/
* 1f0c8de feat: 初始化项目骨架

三个高频参数

  • --oneline:每个提交压成一行,先看结构。
  • --graph:画出分叉与合并的连线。
  • --all:把本地所有分支都纳入,不只看当前分支。

定位“是谁改的”

  • git log -p -- path/to/file:带 diff 看单文件演变。
  • git blame -L 10,20 file:逐行标出最后修改者。
  • git log -S "关键字":搜「哪次提交引入/删除了这段内容」。
提交 ID 可以只写前 7 位。Git 会自动补全;如果短 ID 有歧义,它会提示你写得更长。
07

撤销与后悔药:先判断改动在哪一层

Undo Playbook

Git 的撤销命令之所以让人害怕,是因为同名命令在不同区域、不同状态下含义完全不同。判断顺序只有一个:这个改动提交了吗?推送了吗?

处境命令效果与风险
改了还没 addgit restore <file>丢弃工作区改动,不可恢复 危险
add 了想撤回git restore --staged <file>只移出暂存区,工作区内容保留
刚提交想改信息git commit --amend重写最后一个提交,未推送时安全
提交错了想回退git reset --soft HEAD~1回退指针,改动留在暂存区
已推送但想撤销git revert <id>生成一个反向提交,历史不改写 推荐
切分支后找不到提交git reflog列出 HEAD 全部移动记录,可据此找回
临时切走但不想提交git stash push -m "wip"暂存现场,stash pop 恢复

reset 的三种模式,只差“动不动工作区”

S--soft只移动分支指针。改动全部留在暂存区,适合「提交拆小」。
M--mixed(默认)移动指针 + 清空暂存区,改动回到工作区。
H--hard指针、暂存区、工作区一起重置,未提交改动直接消失。
↺后悔硬重置后仍可从 reflog 找到原提交再 reset 回去。
记忆口诀:共享分支上用 revert(不改历史),本地私有提交才用 reset / amend / rebase(改写历史)。
08

团队协作:一条分支 = 一个可评审的意图

Feature Branch Flow

多人协作的核心不是「怎么推代码」,而是让主干永远可发布:每个改动都从最新的 main 切出短分支,通过 PR/MR 评审后再合回。分支存在的意义,是把「未完成的意图」与「已上线的代码」隔开。

1同步主干git switch main && git pull
2切功能分支git switch -c feat/x
3小步提交一个提交只做一件事
4推送并发起 PR写清背景、方案、影响面
5评审后合入合并后删掉功能分支

联调时的两条常规动作

把主干更新合进功能分支
git fetch origin
git merge origin/main     # 或 git rebase origin/main
# 解决冲突 → git add → git commit
git push
推送前自查
git fetch origin
git status -sb            # 本地领先/落后几个提交
git diff origin/main...HEAD # 本次 PR 的全部改动
git log --oneline origin/main..HEAD

冲突不是错误,只是「Git 不敢替你决定」

冲突只会发生在同一文件的同一区域被两边修改时。Git 会把双方版本都写进文件,用标记包围,等你给出最终答案。

冲突标记长什么样conflict
<<<<<<< HEAD
retries = 3
=======
retries = 5
>>>>>>> feature/retry-policy

# 手工改成最终版本(删掉三行标记)后:
git add config.py
git commit            # merge 场景;rebase 场景用 git rebase --continue
降低冲突概率的工程手段:分支短命(几天内合入)、提交前先同步主干、把大改动拆成多个小 PR、避免多人长时间改同一文件。
09

命令速查:按“想干什么”分组

Cheat Sheet
意图命令说明
看我在哪git status -sb简洁模式,同时显示领先/落后远程的提交数
看改了什么git diff / git diff --staged前者看工作区,后者看已暂存内容
选择性暂存git add -p逐块确认,避免误提交调试代码
提交git commit -m "feat: …"信息写「为什么」,一行标题 + 空行 + 正文
临时保存现场git stash push -u -m "wip"-u 连未跟踪文件一起收走
恢复现场git stash pop恢复并删除该条 stash
切分支git switch <branch>新分支用 -c,比 checkout 语义清晰
抓取但不合并git fetch --prune同步远程引用,顺手清掉已删除的远程分支
拉取并变基git pull --rebase避免本地出现无意义的合并提交
挑一个提交git cherry-pick <id>把一个提交复制到当前分支(如热修回主干)
找回丢失提交git reflogHEAD 移动的完整流水,30 天内都还在
打标签发版git tag -a v1.2.0 -m "…"配合 git push --tags 触发发布流水线
⚙

配置一次,长期生效

git config --global pull.rebase true
git config --global init.defaultBranch main

⌥

别名提速

git config --global alias.lg "log --oneline --graph --all",之后 git lg 即可。

✓

忽略文件

.gitignore 只对未跟踪文件生效;已跟踪的需 git rm --cached 后再忽略。

10

一页速记

Takeaways

如果只带走三句话:提交是快照、分支是指针、历史分本地与共享。其余的 150 多个子命令,都是这三句话的组合与补充。

日常主线

  • git switch main → git pull --rebase
  • git switch -c feat/x
  • 改代码 → git add -p → git commit
  • git push -u origin feat/x → 发起 PR

出问题时

  • 改错未提交:git restore <file>
  • 提交错了:git reset --soft HEAD~1
  • 已推送要撤销:git revert <id>
  • 什么都没了:git reflog

看历史

  • git log --oneline --graph --all
  • git log -p -- <file>
  • git blame -L a,b <file>
  • git show <commit-id>

三条底线

  • 不改写已推送的共享历史
  • 不提交密钥、构建产物、本地配置
  • 一个提交只表达一件事

概念对照表

概念一句话定义对应文件 / 命令
快照 snapshot某次提交时整个项目的完整状态commit 对象
暂存区 index下一次提交的草稿清单git add / git diff --staged
分支 branch指向某个提交的可移动指针.git/refs/heads/*
HEAD“我现在在哪”的指针,通常指向某个分支git switch
远程跟踪分支本地对远程状态的只读镜像origin/main,由 fetch 更新
合并提交有两个父节点的提交,代表一次合流git merge --no-ff
最后一句:Git 从不“删除历史”。你看到的“丢失”,几乎都是没有引用指向某个提交;只要 reflog 还在,就还有救。
Git 图解 · 版本控制基础 snapshot · pointer · graph