在实际开发中，我们经常会遇到需要把分散在不同项目或历史分支的代码整合到一起的情况。比如接手了一个老项目，发现部分功能被拆分成了几个独立的仓库，或者团队重组后需要将多个微服务模块统一到一个主仓库里管理。这时候掌握git合并多仓库的技巧就显得尤为重要。下面用最直白的方式，把整个流程拆解清楚，让你一次性搞定。
准备工作与基础配置
开始之前，请确保你的电脑已经安装好git并且能正常联网。你需要一个目标仓库作为最终代码的存放地，同时准备好所有需要合并进来的源仓库地址。打开终端或命令行工具，先进入目标仓库的本地目录。如果还没克隆下来，先用clone命令拉取一份最新副本。接着执行git config命令设置好全局的用户名和邮箱，这一步是为了保证后续提交的记录规范统一。建议先在本地创建一个干净的临时文件夹，用来存放各个源仓库的提取内容，避免直接污染主分支。
核心合并操作流程
合并的核心逻辑其实很简单，就是把其他仓库的内容当成远程分支拉过来，然后跟主干代码进行融合。首先在目标仓库里添加一个新的远程地址，可以用git remote add other-repo 仓库地址的命令，随便起个容易记的名字。然后运行git fetch other-repo，这步只会下载数据不会修改你本地的文件。接下来最关键的一步是选择合并方式。如果你希望保留完整的提交历史，直接用git merge other-repo/master。如果你更看重时间线的整洁，可以把rebase换成merge。执行完合并命令后，git会自动比对两边的文件差异。没有冲突的话，直接git push origin main推送到服务器就完成了。整个过程通常只需要几分钟。
常见冲突解决技巧
代码合并最怕的就是冲突，尤其是当两个仓库都修改了同一个文件的同一行时。终端会明确标出冲突位置，并用尖括号提示两边不同的内容。你只需要用文本编辑器打开这些文件，手动保留需要的代码，删掉标记符号。改完后记得用git add把修复好的文件重新加入暂存区，然后继续执行git merge --continue。如果中途觉得太麻烦想放弃，随时可以输入git merge --abort回退到合并前的状态。对于大型项目的批量冲突，可以考虑用外部对比工具来辅助处理，效率会高很多。记住冲突不是错误，只是版本控制机制在保护你的代码不被意外覆盖。
注意事项与最佳实践
动手合并前一定要打一个本地标签或者创建新分支做备份，防止操作失误导致无法挽回。合并完成后不要急着推送，先在本地跑一遍测试用例或者启动项目检查依赖关系是否正常。有些仓库可能带有特殊的构建脚本或者环境变量配置，直接拼接到一起容易报错，需要提前梳理清楚路径映射。如果是长期维护的多仓库架构，建议把合并后的结构写成文档说明，标注每个模块的职责边界。日常开发中尽量保持单一职责原则，避免代码再次散落到无数个孤立仓库里。定期清理不需要的远程分支和缓存数据，能让项目仓库保持轻量高效。掌握这套方法后，你就能灵活应对各种复杂的代码整合场景，让团队协作更加顺畅。
