Git
把时间线变成可回放的分支图
Git 不是「带历史记录的网盘」,而是一个内容寻址的快照数据库:每次提交都是整棵目录树的一张照片,分支只是指向某张照片的可移动指针。理解这句话,大部分命令就不再需要死记。
本质:存的不是“改动”,而是“快照”
Snapshot, not diffSVN 等老一代工具以文件差异为中心:每次提交记录「第 3 行加了什么」。Git 反过来——每次提交都给整个项目拍一张快照,记录当时所有文件的完整状态;没变的文件不重复存储,只保留一个指向旧对象的引用。于是「回到任意历史版本」只是换一张照片,不需要把差异一层层重放。
差异存储(SVN 式)
基础文件 + 一串补丁。取版本 v5 要把 5 个补丁依次应用,历史越长越慢;分支在服务端是目录拷贝。
快照存储(Git 式)
每个版本都是一棵完整的树对象,未变内容共享同一 blob。取任意版本都是 O(1) 定位,分支只是 41 字节的指针文件。
关键:内容相同的文件在对象库中只存一份,所以“每次都拍全量照片”并不会让仓库膨胀。
三个对象撑起整个 Git
blob
文件内容的压缩存储,不含文件名。内容相同即同一个 blob。
tree
目录:记录「文件名 → blob / 子 tree」的映射,相当于一次快照的骨架。
commit
指向一棵 tree,外加父提交、作者、时间、说明。历史就是 commit 串成的有向图。
四个区域:一条单向流水线
Working → Index → Repo → Remote新手最常问的「我改了代码为什么别人看不到」,答案永远落在这四个区域的边界上。Git 里每一次改动都要显式地从左边推到右边,没有任何一步会自动发生。
命令总是作用在某两个相邻区域之间: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 一次。第一个仓库:从 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
日常三件套
git status # 看到 hello.txt 是 untracked git add hello.txt # 放进暂存区 git commit -m "feat: 添加问候脚本" git log --oneline --graph # 确认历史
feat: 新功能、fix: 修缺陷、refactor: 重构、docs: 文档、chore: 杂务。团队统一前缀后,git log 本身就是一份变更日志。分支:41 字节的指针,不是目录拷贝
Branch = Pointer创建分支在 Git 里便宜到几乎免费:它只是 .git/refs/heads/ 下一个写着 commit ID 的文本文件。所以「一个功能一个分支」不会带来任何存储或性能负担,反而让主线的历史保持干净。
切分支 = 把 HEAD 指向另一个指针;提交 = 新节点接到 HEAD 后面,并把当前分支指针前移一格。
创建 / 切换
git switch -c feat/login
等价于旧写法 checkout -b,语义更清楚。
删除已合并分支
git branch -d feat/login
指针删掉即可,提交对象仍被其他引用保护。
查看分支拓扑
git log --graph --all --oneline
比只看当前分支更能发现分叉点。
git checkout <commit-id> 会让 HEAD 脱离任何分支。此时提交的节点没有分支指向,切走后很容易「丢失」——用 git switch -c rescue 给它接一个分支即可救回。合并 vs 变基:两种整理历史的方式
Merge / Rebase两条分支各自向前走之后,要把工作合到一起,有两种做法:merge 保留分叉并生成一个合并提交;rebase 把你的提交「摘下来」重新接到对方最新提交之后,得到一条直线。
merge 的代价:历史真实但会分叉;好处是任何时刻都没有改写已有提交,最安全。
rebase 的代价:提交 ID 全变,等于重写历史。只对尚未推送的本地提交做。
| 维度 | merge | rebase |
|---|---|---|
| 历史形态 | 保留分叉,有合并提交 | 一条直线,没有合并提交 |
| 提交 ID | 不变 | 全部重算 |
| 冲突处理 | 一次性解决 | 可能每个提交都要解决一次 |
| 适用场景 | 合入主干、公共分支 | 本地整理、拉取上游更新 |
# 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
读懂提交历史:log 是一张图
Reading the Graph
git log 默认按时间倒序平铺,容易误以为历史是线性的。加上 --graph 才会露出真实结构:分叉、合并、以及每个分支当前指在哪。
* 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 "关键字":搜「哪次提交引入/删除了这段内容」。
撤销与后悔药:先判断改动在哪一层
Undo PlaybookGit 的撤销命令之所以让人害怕,是因为同名命令在不同区域、不同状态下含义完全不同。判断顺序只有一个:这个改动提交了吗?推送了吗?
| 处境 | 命令 | 效果与风险 |
|---|---|---|
| 改了还没 add | git 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 的三种模式,只差“动不动工作区”
reflog 找到原提交再 reset 回去。revert(不改历史),本地私有提交才用 reset / amend / rebase(改写历史)。团队协作:一条分支 = 一个可评审的意图
Feature Branch Flow多人协作的核心不是「怎么推代码」,而是让主干永远可发布:每个改动都从最新的 main 切出短分支,通过 PR/MR 评审后再合回。分支存在的意义,是把「未完成的意图」与「已上线的代码」隔开。
git switch main && git pullgit switch -c feat/x联调时的两条常规动作
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 会把双方版本都写进文件,用标记包围,等你给出最终答案。
<<<<<<< HEAD retries = 3 ======= retries = 5 >>>>>>> feature/retry-policy # 手工改成最终版本(删掉三行标记)后: git add config.py git commit # merge 场景;rebase 场景用 git rebase --continue
命令速查:按“想干什么”分组
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 reflog | HEAD 移动的完整流水,30 天内都还在 |
| 打标签发版 | git tag -a v1.2.0 -m "…" | 配合 git push --tags 触发发布流水线 |
配置一次,长期生效
git config --global pull.rebase truegit config --global init.defaultBranch main
别名提速
git config --global alias.lg "log --oneline --graph --all",之后 git lg 即可。
忽略文件
.gitignore 只对未跟踪文件生效;已跟踪的需 git rm --cached 后再忽略。
一页速记
Takeaways如果只带走三句话:提交是快照、分支是指针、历史分本地与共享。其余的 150 多个子命令,都是这三句话的组合与补充。
日常主线
git switch main→git pull --rebasegit 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 --allgit 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 |
reflog 还在,就还有救。