本文档说明如何将自己的开发分支合入develop供测试环境验证。总流程Git 分支开发指南正式发布Main 正式环境合并说明冲突协助Git 冲突与 AI 协助指南Develop 是什么develop是测试环境的集成分支可能同时包含多个尚未上线的需求需求 A ──┐ 需求 B ──┼──→ develop → 测试环境 需求 C ──┘因此开发分支可以合入develop。不要从develop创建开发分支。不要把develop合入开发分支。不要直接在develop上修改具体需求。不要用develop向main发布。下文命令中的开发分支是占位符需要替换为真实分支名。合并前检查先回到自己的开发分支确认修改已经提交并推送gitswitch开发分支gitstatusgitpushgit status应提示工作区没有未提交修改。若仍有文件未提交先确认原因不要带着不明修改继续合并。方式一通过 MR 合并新手优先使用 MR因为可以在合并前集中查看 Diff、CI 和冲突。在代码平台创建Source: 开发分支 Target: develop合并前依次检查Source 和 Target 是否正确。Diff 是否只包含当前需求。CI 和构建是否通过。是否意外带入其他需求代码。平台是否提示冲突。检查通过后开发人员可以自行 Merge不要求其他人员审批。如果 MR 提示冲突不要执行“develop → 开发分支”。转到本文的冲突处理在本地develop上合入开发分支并解决。方式二在本地直接合并先确保自己的开发分支已经提交和推送然后更新本地developgitswitch developgitpull --ff-only origin developgitlog--onelineorigin/develop..developgitmerge开发分支合并前git log应没有输出如果列出了提交说明本地develop还有未推送内容应先确认这些提交的归属。没有冲突时先检查本次合并结果gitstatusgitdiffORIG_HEAD--stat确认无误后推送gitpush origin develop如果git pull --ff-only失败说明本地develop和远端历史不一致。不要强制推送也不要自行改写公共分支历史先交给熟悉 Git 的同事或 AI 工具分析。冲突处理为什么要在 develop 上解决假设develop已经包含需求 A、B、C而你的开发分支只包含需求 Adevelop: A B C 你的分支: A如果将develop合入你的分支你的分支也可能包含 B、C。之后再用该分支向main发起 MR就可能把尚未允许上线的代码一起带入正式环境。所以本场景的固定规则是开发分支 → develop 发生冲突 ↓ 在 develop 上解决直接合并时发生冲突执行以下命令后gitswitch developgitpull --ff-only origin developgitmerge开发分支Git 可能显示CONFLICT (content): Merge conflict in ... Automatic merge failed; fix conflicts and then commit the result.先查看现场不要继续推送gitstatusgitdiff--name-only --diff-filterU此时推荐让具备仓库访问权限的 AI 编码工具完整处理冲突。告诉 AI 当前正在“将开发分支合入develop”并要求它同时保留develop和开发分支中的全部有效功能。只有两边修改的是同一个功能点并且业务方向互斥、无法同时成立时AI 才应暂停并请人工确认不能自行选择一边。可直接使用 Develop 冲突提示词。MR 提示冲突如果“开发分支 →develop”的 MR 提示冲突不要在开发分支执行gitmerge develop正确做法是改为本地合并gitswitch developgitpull --ff-only origin developgitmerge开发分支然后在develop上处理冲突。处理完成并验证后将develop推送到远端。冲突解决完成先确认已经理解并整理好每个冲突文件的最终逻辑然后暂存解决结果gitadd已解决的文件路径gitstatusgitdiff--cached--checkgitdiff--cachedgit status中不能再有unmerged paths。完成定向测试后提交并推送gitcommit-mmerge: 解决 develop 合并冲突gitpush origin develop推送后继续在测试环境验证当前需求。同一功能点方向互斥如果 AI 判断两边修改的是同一个功能点并且业务方向互斥、无法同时成立应保持冲突现场并请需求负责人或相关代码负责人确认。人工确认方向后再让 AI 继续完成修改和验证。如果需要先恢复到合并前状态gitmerge--abortgitstatus取消合并只会回到合并前状态不会删除已经正常提交的开发分支代码。测试发现问题不要直接在develop修复需求。回自己的开发分支修改gitswitch开发分支# 修改并检查代码后gitadd文件路径gitcommit-mfix: 修复测试发现的问题gitpush然后重新执行“开发分支 →develop”并继续测试。检查清单当前操作方向是“开发分支 →develop”。没有将develop合入开发分支。合并结果同时保留了develop和开发分支中的有效功能。同一功能点存在互斥方向时已经完成人工确认。git status中没有未解决冲突。Diff、CI、构建和定向测试均正常。测试修复仍然提交在自己的开发分支。测试通过后继续阅读 Main 正式环境合并说明
