共 3 篇文章
多人协作时，分支生命周期短且需频繁同步主干用 rebase，独立功能需保留合并节点用 merge。核心差异在于：rebase 生成线性历史但重写时间语境，冲突按提交逐个重放、成本随提交数上升；merge 保留分叉上下文，冲突一次性解决、成本随文件数上升。公共分支禁止 rebase，单人短分支可安全使用。实测显示 rebase 即时冲突成本高但长期追溯快，merge 反之。建议以 20 个提交和协作人数为阈值切换，采用混合策略。
落后三个月的分支一次性合入风险极高，通过差距分析、按可独立验证的功能单元拆分、分批合入，将冲突解决时间从预估两周压缩至4个工作日。核心做法包括：先统计diff和commit摸清规模，废弃过时改动；按业务功能而非commit拆分27个块，优先合入基础设施和迁移脚本；用cherry-pick配合逐文件审查，每批跑完整CI；分批还使代码评审可行，发现隐藏bug。
从单体 OpenAPI 文件迁移到多文件结构，是解决接口文档冲突的根本方法。通过按模块拆分规范文件，并利用构建命令拼装完整文档，可将冲突率降低 90% 以上。核心操作包括：将路径、模式等定义拆分为独立文件，用 `$ref` 在入口文件中组装，并借助 Redocly CLI 进行构建与校验。对于同一模块的并发修改，可进一步按 HTTP 方法拆分文件。若冲突发生，使用 Git 的 `union` 合并策略和编辑器插件能高效解决。