版本管理(2)
Version control, part two
从 Merge、Rebase 和工作树理解并行协作的隔离与集成。
阅读目标与前置知识3 项目标
- 比较合并与变基的历史表达
- 说明工作树能隔离与不能隔离的资源
- 为并行修改设计集成检查
建议先读 第 3 讲
一、并行开发要合并的是一致的变化
一个需求会同时改变规格、代码、测试和说明。多个 Agent 可以很快产生提交,合并压力也会增加。需要定义每个任务的边界、合入时验证什么,以及发现冲突后怎样恢复。
课上以可持续运行的个人 Agent 为项目背景。资料库和邮件可以先做一小段可用流程,再不断加入需求。只有经历几次真实变更,才能观察当前结构是否能支撑下一阶段。把工程进度理解为一连串可验证的状态,比用生成代码的数量衡量更贴近项目风险。
二、一项小步修改怎样跨过多个文件
- 定位变化。把本轮目标写成一条具体需求,例如给检测工具增加一类用例。
- 找相关关系。从需求找输入格式、实现和测试。若输出格式改变,再找文档和下游调用者。
- 一起更新。让变化所影响的几处内容在同一次可审查的提交中保持一致。
- 验证并记录。运行对应检查,交代这个提交依赖什么。后续如果发现问题,可以回到上一个一致状态。
课堂探讨了由 Agent 根据任务生成局部项目视图,让开发者快速看见相关文件、测试和设计关系。这个视图帮助发现工作范围,最终仍由仓库里的实际差异和检查来判断改动。
三、Merge、Rebase 与逻辑改动
假设主线和工作分支从 A 开始分叉,主线增加 B,工作分支增加 C 和 D。
| 操作 | 发生什么 | 对协作的影响 |
|---|---|---|
| Merge | 把两条分支现有提交放进共同历史,必要时生成带两个父提交的 M | 原有提交 ID 保留,分叉和汇合可见 |
| Rebase | 把 C、D 的改动重放到 B 之后,形成 C′、D′ | 阅读顺序更线性,原提交 ID 可能变化,重放时仍可能冲突 |
| Jujutsu 的 change 概念 | 给逻辑改动自己的标识,课程用它展示怎样跨重写追踪改动 | 可以区分「在做的同一项修改」和「它当前落在哪个提交对象」 |
Rebase 中的冲突需要按照重放位置逐个处理。分支已在其他地方被使用时,重写历史会影响已有引用。仓库应当先明确怎样合入、哪些分支允许重写,以及谁负责验证合并结果。
四、用工作树隔离文件操作
git worktree 允许一个仓库使用多个检出目录。工作树共享仓库数据,但各自有工作区、索引和检出位置。按不同分支分配给 Agent,可以避免两个工作进程在同一目录覆盖文件或误用同一暂存区。
| 责任 | 可以怎样安排 |
|---|---|
| 划分任务 | 先识别会同时改的接口、文件和测试,再划分相对独立的责任 |
| 各自执行 | 每个 Agent 在自己的工作树改动、运行测试、提交并记录 |
| 处理共享设计 | 约定接口和数据格式。相同部分的改动可按顺序推进 |
| 整合 | 汇合前同步基础,解决冲突后检查端到端功能和兼容性 |
隔离解决的是文件操作相互踩踏的问题。两个任务如果基于不同接口假设,各自在工作树里也能通过测试,合并时仍可能暴露问题。集成验证需要覆盖它们共同依赖的行为。
五、用并发控制理解合入策略
课堂借数据库事务和操作系统的锁解释多个改动。一个事务按原版本正确执行,另一个事务也可能正确,但两者的组合取决于读写顺序和共享资源。软件开发里的「共享资源」可能是同一段代码,也可能是同一条业务约定。
- 彼此独立的工作可以同时推进,汇合时检查组合后的完整流程。
- 共享边界明确的工作可以先固定契约,再并行实现契约两侧。
- 需要同时改共同规则的工作适合设定提交顺序或明确责任人,以减少相互覆盖和反复返工。
锁的粒度决定有多少工作能并行。在软件项目中,锁住所有改动容易理解,也会减少可并行的工作。职责、接口和验证越明确,可安全并行的工作就越多。
六、工作树与合入的完整推演
假设两个 Agent 基于同一状态制作个人助手。一个更新记忆数据的有效期限,另一个更新界面。版本管理允许它们各自迭代,项目要进一步约定数据的含义和更新时间。
- 共享定义。 先统一字段含义、旧记录默认值、期限边界和查询结果。
- 分别执行。 在各自工作树提交。数据侧验证新旧记录,界面侧验证正常、过期和缺失三种输入。
- 汇合验证。 用真实接口运行界面路径,检查双方选择的默认值和错误处理是否一致。
- 记录影响范围。 若同一要求需要修改规格、存储、查询和测试,写出关联。后来变更期限策略时可沿这些依赖定位。
工作树让两个目录各有 HEAD 和索引,本地对象和许多引用仍共享。原型应确认配置、钩子、测试端口或数据目录是否也独立。第 10 讲讨论的钩子配置案例可以作为反例,告诉我们隔离范围要根据实际资源判断。
事前互斥和事后合并各解决什么
| 情形 | 合用的机制 | 需要留下的证据 |
|---|---|---|
| 修改独立功能,冲突概率低 | 各自提交,汇合时验证 | 独立测试和集成结果 |
| 多个任务都会更改记忆格式 | 先统一接口,必要时对共享资源互斥 | 获取边界后读到的最新状态与变更 |
| 同一任务需要更新接口与调用者 | 按不变量覆盖多个文件,或设置交付顺序 | 契约测试和迁移步骤 |
| 连续大量提交导致互相覆盖 | 缩小任务,明确责任与整合顺序 | 可追踪的任务结果和剩余失败 |
课堂用数据库多版本并发控制来类比各自推进再协调的方式。上锁流程还要处理失败退出后如何释放、拿到锁后重新读什么,以及多资源获取如何避免相互等待。选择机制以前,应弄清共享的是文件、数据还是规则。人员或 Agent 增多时,清楚的接口可以减少大量两两协调。
七、Pico Playground 怎样复用 Git 的历史结构
讲义把小学生解汉诺塔的过程看成可回放、可分叉的工作。最终盘面只能说明结果。保留若干有意义的尝试,可以看出学生在哪一步卡住、收到提示后修改了什么。Git 的提交可以保存动作序列与阶段状态,分支容纳不同路线,diff 帮助比较修改,点评可指向一个确定版本。课程还提到用 git notes 追加说明。
相应的数据可以分层。关键尝试需要可比较的历史,细粒度鼠标事件更适合时间序列或事件日志,用户资料与课程关系则由方便查询的模型管理。这个案例补充了课堂给出的通用 API、数据库和对象存储方案。看清真正需要回放和比较的对象,可以先利用现有抽象解决一部分需求,然后用真实使用检验选型。
八、从偏离要求的原型重新识别需求
课堂用个人资料管理引出一个偏离目标的原型。提示里提到了类似成品的界面和一些技术词,模型把这些描述当成要实现的功能。讲师重新梳理资料怎样进入系统,用户如何在本地归类,邮件原文、索引和草稿分别怎样保存。
| 观察到的操作 | 可推导的设计问题 |
|---|---|
| 人需要直接整理本地资料 | 文件和目录是否更贴合交互习惯? |
| 程序需要查询索引、保存草稿 | 哪些结构化数据值得由数据库管理? |
| 内容和索引都在演变 | 哪些结果可以重建,更新依赖如何记录? |
这个例子可以用来检验前面的工作流。先定一条真实操作路径,做一小步验证。发现意图不对时及时调整任务说明,再分配并行实现。团队越能说明一条改动怎样从需求走到验证,Agent 的吞吐量就越能转化为有效进展。
复习与应用
给三个 Agent 分配「修改数据格式」「更新界面」「补测试」三项工作。标出哪些任务可并行、哪个接口先要定下来,以及合入时用什么命令或场景检查三者一致。
停一下,解释给自己听。
两个 Agent 在不同工作树里开发,为什么仍可能互相影响?
展开答案要点
工作树隔离文件现场,但分支引用、外部服务、端口、数据库和合入目标仍可能共享。需要识别共享资源,并对集成后的整体行为重新验证。
已读由你决定,不代表自动评估掌握程度。