版本管理(1)

Version control, part one

第 03 讲约 7 分钟阅读官方讲义 ↗

把编辑现场、暂存内容和提交快照分开,建立可追踪的变化。

阅读目标与前置知识3 项目标
  • 预测编辑、暂存、提交后各区域的内容
  • 解释 Git 对象与分支引用的区别
  • 从共同基线分析合并冲突

建议先读 第 1 讲

Git暂存区IndexCommit三方合并
本章关联演示提交的,到底是哪一版?

一、仓库保存了软件的哪些信息

软件项目包括代码、规格、文档、测试和交付配置。文件系统让人能访问当前内容,版本控制还要说明每项内容从哪里来、某次变化为什么发生、两个分支的工作怎样汇合。

课堂从本地目录和远端仓库的关系讲起。本地可先编辑、试运行和组织提交。远端为协作提供共同参照。读一个成熟的 GitHub 仓库,可以从入口说明、目录边界、问题记录和代表性提交四处入手。它们分别回答怎么使用、代码按什么分工、什么问题促成改动,以及维护者怎样解释这个决定。

二、Git 的数据模型

从文件内容到提交图

对象或引用 保存什么 能回答的问题
Blob 一份文件内容 这个文件版本的内容是什么?
Tree 一组路径条目,指向 blob 或子树 这个版本的目录结构是什么?
Commit 指向根树和父提交,附带提交信息 这个版本是什么,从哪些版本演进而来?
分支引用 指向当前分支尖端的提交 某项工作推进到哪里了?
HEAD 当前检出位置,通常关联一个分支 工作区以哪个提交或分支为起点?

Git 的语义可以理解为快照。一次编辑只影响对应内容、到根的目录关系及新提交。未改变的对象可以复用。分支创建时只需要新引用,后续各分支的提交关系形成有向图。理解对象和引用以后,git status、切分支和历史浏览就能从同一个模型推导。

把工作区、暂存区和提交分开看

工作区含当前编辑,暂存区决定下一次提交包含什么,提交是保存到历史里的版本。一次改了多个文件时,可以只挑选一部分暂存并确认差异。课堂强调,暂存区给开发者一个机会,把现场改动整理成对别人有意义的变化。

常用检查顺序是运行 git status 看状态,运行 git diff 看未暂存差异,再运行 git diff --cached 确认准备提交的差异。暂存以后又修改了同一个文件,工作区内容和已经暂存的内容可能不同。

三、从工作命令验证版本模型

讲义用可视化工具 gitv 连起磁盘内容和 Git 概念。学习时可以先预测动作,再读对象证实。下面的观察顺序适用于已有至少一次提交的练习仓库。

动作 预期变化 观察方法
编辑已跟踪文件 工作区变化,暂存内容仍指向原版本 对比 git diff 和 git diff --cached
暂存编辑 索引记录新内容,当前提交位置保持原样 对比 git ls-files --stage 与 git show HEAD:路径
提交 创建提交和必要的树对象,当前分支引用前移 用 git cat-file -p HEAD 观察 tree 和 parent
从共同版本另开分支 分支可指向同一提交,后续各自推进 用 git log --graph --oneline --all 查看
合并时遇到文本冲突 工作区可见冲突内容,索引保留各侧记录 用 git ls-files -u 核对对应路径

对象的身份和引用的位置是两层信息。提交对象记录快照与父提交,分支引用说明工作当前推进到哪里。引用可以移动,已经产生的对象为历史查找提供依据。误移动引用时可以先查看 reflog 寻找旧位置。还在编辑器里的未提交工作需要另有检查点,远端只能看到已经推送的内容。

冲突诊断从文字继续追到行为

假设模板把默认间隔从 5 改到 10,学生同时把它改到 3。先确认老师的更新想修什么,学生的变化是不是只对自己的实验数据有效,再判断全局默认和用户选项如何表达。同一个文件即使没有冲突标记,调用者仍可能把 5 当成固定前提。完成合并时应该验证默认值、手动设置与旧配置的读入。

四、用学生作业理解三方合并

老师发布了第一版模板,学生从它出发完成作业。老师又更新了模板。此时需要合并两人从同一版本出发做的不同工作。

  1. 找到共同基线(base),还原老师和学生起初看到了什么。
  2. 分别比较当前侧(ours)和合入侧(theirs)相对基线有哪些变化。
  3. 独立改动通常可以组合。同一位置出现不同意图时,先读双方改动的理由,再决定解决方式。
  4. 合并完成后运行能覆盖共同功能的验证。没有文本冲突也可能出现语义冲突,例如一侧改变了默认值,另一侧还依赖原默认值。

课上通过读取真实仓库和索引,展示冲突时保留的 base、ours 与 theirs 三份内容。价值在于恢复比较依据。只看冲突标记提示的两段文字,很难理解双方为什么分别改成这样。

五、把能重建的产物和项目源材料分清

文件类型 判断方式
代码、规格和必要测试 是否定义或者验证了团队共同维护的行为
构建目录、日志和临时文件 是否能重建,是否需要作为项目输入长期共享
编辑器与本机设置 是否有团队共用价值,是否依赖本机路径
发布和依赖相关文件 是否为复现交付所必需,是否符合项目已有发布约定

课程从自动生成的文件误入仓库讲到忽略规则和检查。一条规则如果能反复机械判断,可以让工具在提交前提示。需要理解项目目的的改动,仍由团队规则和评审承担。

六、用提交历史支撑审查和排错

以变更目的确定提交粒度

一项改动可以包含实现、对应测试和必要文档,只要这些内容都服务于同一个目的。与功能无关的大量格式化或准备性重构尽可能独立组织。否则审查者难以判断改动的范围,撤回时也会带走无关工作。

提交说明可由短标题和必要说明组成。标题概括可观察的变化,说明解释取舍、约束与相关问题记录。课程展示了用真实项目历史观察提交习惯,重点是长期保持一致,并给后来的开发者留下可读的理由。

用历史给回归定位缩小范围

当一个行为曾经正确、现在错误,可以选一段已知范围,用 git bisect 和可复现的检查定位最早引入问题的提交。可以用 git blame 找到某行最后一次相关编辑,再读提交说明理解当时的上下文。定位贡献者只是找到线索的一步,最终要确认具体变化和失败之间的关系。

小步提交能让这些方法更有效。一次提交涉及许多不相关工作,即便找到出错版本,仍要在大范围差异中寻找原因。

七、一行修正背后的工程工作

讲义借 SWE-bench 里的 Astropy 题说明补丁为何需要项目上下文。独立的计算放在一起时,依赖矩阵仍应保留它们各自的输入输出关系。嵌套组合后,旧实现把右侧已经算出的矩阵区域整体标成真,导致原本独立的输入看起来互相影响。修正是在拼接时保留右侧矩阵,验证则要覆盖不同嵌套组合和原有用法。

这条工作路径有四个检查点。首先复现用户报告的问题。其次定位代码破坏了哪项表示约定。然后让原失败案例随修复变成通过。最后确认已有用法继续正常。SWE-bench 的 FAIL_TO_PASS 和 PASS_TO_PASS 分别对应后两类证据。真正接手仓库还要解释修改动机、组织提交并检查集成结果。

从小约定练习工程判断

讲义举了 TYPO-CHECK 规则标识。大小写影响视觉区分和文本引用,但选择要看项目已有命名方式和工具要求。相似的判断也适用于 .gitignore。日志和本机配置通常无需进入共享历史,锁文件虽然由工具生成,却可能承担复现安装的职责。由用途决定是否跟踪,可以解释什么时候需要不同做法。

八、把仓库用作 Agent 交付记录

让 Agent 在读懂现有历史和项目约定后,每完成一项可描述、可验证的工作就留下检查点。好的检查点能回答改了什么、验证了哪些行为、下一项变化依赖什么。课程中的线性历史属于一类合入约定,第 4 讲会说明它怎样影响多 Agent 工作。

复习与应用

拿一段包含功能、格式化和说明修订的真实差异,按提交目的重新组织。再找两个修改过同一文件的分支,用共同基线解释冲突,写出合并后必须共同成立的两条行为。

第 3 讲官方讲义

停一下,解释给自己听。

暂存 interval=10 后又改成 3,直接提交会保存哪个值?

展开答案要点

提交保存暂存区的 10,工作区仍是 3。新提交与暂存区相同,工作区相对暂存区仍有未暂存的变化。

为这次阅读留下一个标记。

已读由你决定,不代表自动评估掌握程度。

学习记录,留在这里。

阅读位置、已读章节和实验清单保存在当前浏览器。更换浏览器或清理站点数据后,这些记录不会同步。

0 / 12 讲已标记为已读

Search the course
输入关键词,或从下方开始。
试试 暂存区、CQRS、不变量Esc 关闭 · Tab 选择结果