1 / 4概念
Version Control
版本控制把“谁在什么时候为什么改了哪一行”变成可查询的对象图。判断标准不是命令记得多不多,而是能否在冲突、回滚和多人协作时保住历史。
1 概念
1.1 一句话定义
版本控制是一个内容寻址的不可变对象数据库,加上一组可移动的引用。Git 把文件内容存成 blob,把目录存成 tree,把一次快照存成 commit,再用分支、标签和远程引用给这些对象命名。
1.2 它解决什么问题
- 多人同时改同一份代码时,需要合并而不是互相覆盖。
- 线上问题时,需要定位“哪一个提交引入了变化”,并安全回滚。
- 发布时,需要把某个可复现的快照固定下来,供构建和追溯。
没有版本控制,回滚靠备份,协作靠口头约定,问题定位靠猜。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 流水线触发、缓存与发布 | CI/CD |
| 提交前的规则检查与格式检查 | Code Quality |
| 依赖包与制品仓库 | Private Registry |
| 供应链签名与 SBOM | Supply Chain Security |
| 代码托管平台的账号与权限模型 | 平台自身文档 |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 工作区 | 磁盘上正在编辑的文件 | 不是提交历史 |
| 暂存区 | 下一次提交要包含的快照 | 不是“已提交” |
| HEAD | 当前检出的提交或分支指针 | detached 时指向提交而非分支 |
| ref | 指向对象的可变名字,如分支、标签 | 标签通常不可变 |
| merge base | 两个分支的最近共同祖先 | 不是“当前分支的父提交” |
| fast-forward | 目标分支是当前分支祖先,直接前移指针 | 不产生 merge commit |
| rebase | 把提交逐个重放到新基底 | 会改写提交 ID |
| LFS | 把大文件内容放到独立存储,仓库只留指针 | 不是压缩 |
2 机制
2.1 心智模型
Git 是一张有向无环图:commit 指向 tree,tree 指向子 tree 和 blob;每个对象的内容决定它的哈希,因此历史不可篡改。分支只是贴在某个 commit 上的便利贴,移动分支不改变历史。
2.2 机制拆解
- 提交:
git add把工作区内容写入暂存区(生成 blob/tree),git commit生成一个 commit 对象,更新当前分支 ref。 - 分支:
git switch -c新建一个 ref;切换分支只改工作区和 HEAD,不复制对象。 - 合并:找到 merge base,做三方合并;无冲突时生成 merge commit,有冲突时进入冲突状态,解决后
git commit。 - 变基:找到当前分支相对上游的提交,逐个重放到新基底;冲突逐个解决,提交 ID 全部改变。
- 远程:
fetch只更新远程跟踪 ref,pull等于 fetch + merge/rebase,push把本地 ref 写到远程。
2.3 完整枚举
| 对象/引用 | 内容 | 可变性 | 作用 |
|---|---|---|---|
| blob | 文件字节 | 不可变 | 存文件内容 |
| tree | 目录项(模式、类型、哈希、名字) | 不可变 | 存目录结构 |
| commit | tree、父提交、作者、提交者、消息 | 不可变 | 存一次快照 |
| annotated tag | 目标对象、标签名、签名、消息 | 不可变 | 发布标记 |
| branch ref | 指向 commit | 可变 | 开发线 |
| remote-tracking ref | 远程分支的本地镜像 | 可变 | 跟踪上游 |
| HEAD | 指向 branch 或 commit | 可变 | 当前位置 |
| index | 暂存区快照 | 可变 | 组织下一次提交 |
常见合并策略:
| 策略 | 历史形状 | 是否保留分支 | 适用 |
|---|---|---|---|
| fast-forward | 线性 | 不保留 | 短分支、个人分支 |
| merge commit | 分叉后汇合 | 保留 | 公共分支、发布分支 |
| squash merge | 线性、单提交 | 不保留 | PR 合并、追求整洁历史 |
| rebase merge | 线性、逐提交 | 不保留 | 需要保留原子提交 |
| cherry-pick | 复制单个提交 | 不保留 | 热修复、回移补丁 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 对象哈希 | 40 位十六进制(SHA-1) | 仓库可配置 SHA-256 |
| commit 大小 | 几百字节 | 主要是消息和元数据 |
| packfile 压缩 | 通常 2–10 倍 | 相似对象做 delta |
| 克隆深度 | --depth 1 只取最近一次 | 历史追溯会受限 |
| LFS 指针 | 约 130 字节 | 真实内容在 LFS 存储 |
3 实践
3.1 最小示例
# 初始化并完成一次可追溯的提交
git init
git add -p # 逐块确认要暂存的改动
git commit -m "feat(auth): reject expired refresh tokens"
git switch -c fix/token-race
git add src/auth/token.ts
git commit -m "fix(auth): serialize refresh token rotation"
# 同步上游后变基,保持线性历史
git fetch origin
git rebase origin/main
git push --force-with-lease origin fix/token-race
# 大文件走 LFS,仓库只保留指针
git lfs install
git lfs track "*.psd"
git add .gitattributes design/home.psd
git commit -m "chore(design): add home page source"
3.2 常用操作与参数
| 操作 | 命令 | 说明 |
|---|---|---|
| 查看状态 | git status -sb | 简洁显示分支与变更 |
| 查看历史图 | git log --oneline --graph --decorate | 看分叉与合并 |
| 暂存部分改动 | git add -p | 逐块选择,避免夹带 |
| 撤销工作区改动 | git restore <file> | 不改变历史 |
| 撤销暂存 | git restore --staged <file> | 回到未暂存 |
| 安全回滚提交 | git revert <sha> | 生成反向提交,不改历史 |
| 修改最近提交 | git commit --amend | 只用于未推送的提交 |
| 交互式整理 | git rebase -i HEAD~n | squash/fixup/reword |
3.3 标准流程
- 从最新主干切出短分支,小步提交,每个提交只做一件事。
- 推送前先 fetch/rebase,解决冲突并跑本地检查。
- 开 PR/MR,附上变更范围、风险、验证方式和回滚方案。
- 评审通过后按团队策略 merge/squash/rebase,删除远端分支。
- 发布打 annotated tag;需要追溯时从 tag 构建。
- 线上问题用 revert 而不是改写已发布历史。
3.4 与相邻技术的组合
- CI/CD:push/PR 触发流水线,提交 SHA 是构建与制品的关联键。
- 代码质量:pre-commit 跑格式与 lint,CI 再跑全量检查。
- 供应链安全:tag 签名、提交签名和制品 provenance 共同证明来源。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 团队规模 | 单人 / 小团队 / 大团队 | 决定评审与保护分支强度 |
| 发布节奏 | 持续 / 周期 | 决定 trunk-based 还是发布分支 |
| 历史要求 | 线性 / 保留分支 | 决定 merge 还是 squash/rebase |
| 合规 | 需要审计 / 不需要 | 需要签名、保护分支、审计日志 |
| 仓库体积 | 小 / 大文件多 | 决定 LFS、浅克隆、partial clone |
3.6 决策规则
- 个人分支、未推送:可以 amend/rebase;已推送的公共分支不要改写。
- 公共分支合并:用 merge commit 保留上下文,或用 squash 保持线性;团队二选一并写进规范。
- 发布分支:只接受 cherry-pick 的热修复,不再合入新功能。
- 大文件:超过几十 MB 就上 LFS,不要塞进普通提交。
- 安全回滚:优先 revert;只有未发布历史才考虑 reset。
- 仓库太大:先浅克隆/partial clone,再评估拆分。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| merge commit | 保留真实分叉与合并 | 历史图复杂 | 公共分支、发布分支 |
| squash merge | 历史线性、每个 PR 一个提交 | 丢失中间提交 | 小型 PR、追求整洁 |
| rebase merge | 线性且保留原子提交 | 需要解决多次冲突 | 提交质量高的团队 |
| fast-forward only | 最简单、完全线性 | 要求分支始终基于最新 | 小团队、trunk-based |
| GitFlow | 角色清晰、适合版本发布 | 分支多、合并成本高 | 有明确版本窗口的产品 |
3.8 何时不该用
- 把 Git 当网盘:频繁提交大二进制文件,克隆会越来越慢;用 LFS 或制品库。
- 用
push --force覆盖公共分支:会丢别人的提交;用--force-with-lease且仅限个人分支。 - 在共享分支上 rebase:所有协作者都要重建本地分支。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 切分支后提交“消失” | detached HEAD 上提交,没建分支 | git switch -c <name> 接住提交 |
| 推送被拒绝 | 远程有新提交,非快进 | fetch + rebase/merge 后再推 |
| 强推后别人的提交没了 | 覆盖了公共分支 | 从 reflog 恢复,改用保护分支 |
| 合并后出现冲突标记 | 冲突未解决就提交 | 搜索 <<<<<<<,解决后重新 add |
| 克隆后图片打不开 | 只拿到 LFS 指针 | git lfs pull,检查服务端 LFS |
| 整个文件显示已修改 | 换行符或文件模式变化 | 统一 .gitattributes,检查 core.fileMode |
| 历史里出现密钥 | 曾提交敏感信息 | 轮换密钥,再用 filter-repo 清理 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
git add . 后直接提交 | 夹带无关文件、密钥、构建产物 | git add -p + .gitignore |
| 在主干直接开发 | 冲突集中、回滚困难 | 短分支 + PR |
| 把 lockfile 当二进制忽略 | 构建不可复现 | 提交 lockfile |
| 用 reset 回滚已发布提交 | 历史分叉、协作者混乱 | revert |
4.3 可观测信号
git log --graph 看分叉与合并,git fsck 查对象完整性,git count-objects -vH 看仓库体积,git reflog 找回误操作,平台侧看保护分支拦截、评审时长和 CI 通过率。
4.4 安全 / 性能 / 一致性边界
- 安全:提交签名和 tag 签名只证明“谁签的”,不证明代码安全;密钥永不入库。
- 性能:仓库体积随二进制历史增长,浅克隆会牺牲追溯能力。
- 一致性:已发布历史不可改写;rebase 只用于未共享的提交。