这确实是大型定制开源项目维护中最头疼的问题之一——既要跟上上游的安全补丁和功能更新，又不能搞崩自己辛辛苦苦做的定制逻辑。结合我参与过的几个大型ROM和定制浏览器项目经验，分享一套可落地的流程：

在开始定制之前，千万别上来就对着上游代码乱改，否则后面同步的时候绝对会哭。

• 物理隔离核心代码：把上游的原始代码放在单独的目录（比如upstream/），自己的定制代码放在custom/目录，通过脚本或者构建工具把两者整合起来。比如定制ROM的话，上游的AOSP代码不动，自己的定制模块放在vendor/或者custom/目录，通过Android.mk来引入。
• 记录所有修改点：建一个MODIFICATIONS.md文档，详细记录每个定制修改：哪个文件、修改了什么逻辑、为什么要改。比如“修改了browser/ui/toolbar.cpp中的按钮布局，因为客户需要添加自定义客服入口”。后期同步的时候，这个文档会帮你快速回忆哪些是不能动的核心定制。

用分支把上游代码和定制代码彻底隔离开，这是Git层面的关键：

• 维护一个纯上游镜像分支：比如叫upstream-main，这个分支永远只拉取上游的最新代码，不做任何定制修改。每次上游更新，就把代码拉到这个分支里。
• 定制开发分支：比如叫custom-main（或者团队协作用的develop），所有的定制修改、新增功能都在这个分支提交。这个分支基于upstream-main初始化，后续的同步操作都是从upstream-main合并到这里。
• 可选：紧急修复分支：如果上游出了严重安全漏洞，需要快速同步补丁，可以拉一个hotfix-upstream分支，基于upstream-main的补丁修改，再合并到custom-main。

每次同步的时候按这个步骤来，能避免很多混乱：

1. 更新上游镜像分支：

   git checkout upstream-main
   git pull upstream main  # 这里的upstream是你添加的上游远程仓库地址
   

2. 切换到定制分支，暂存本地未提交的修改：

   git checkout custom-main
   git stash  # 如果有正在开发的未完成代码，先暂存起来，避免冲突
   

3. 合并上游代码到定制分支：

   git merge upstream-main
   

   这时候Git会自动处理能合并的部分，有冲突的文件会标记出来。
4. 处理冲突、测试、提交：
   • 逐个解决冲突文件，优先处理上游修改但你没动过的文件（直接接受上游修改即可）；对于你定制过的核心文件，要仔细对比上游的修改点，判断是需要合并上游的逻辑（比如安全补丁），还是保留自己的定制。
   • 解决完所有冲突后，一定要跑一遍核心功能测试，确保定制的逻辑没被破坏。
   • 提交合并结果，然后恢复暂存的代码：

     git commit -m "Sync upstream latest changes"
     git stash pop
     

大型项目冲突是不可避免的，但掌握技巧能大幅降低处理成本：

• 用可视化工具处理冲突：别死磕命令行的git diff，用VS Code、IntelliJ或者SourceTree的可视化冲突解决工具，能直观看到上游和自己的修改，一键选择保留哪部分。
• 给定制文件设置合并策略：对于自己新增的完全独立的定制文件，可以在.gitattributes里设置合并策略，比如：

  custom/** merge=ours
  

  这样Git在合并的时候会自动保留你的定制文件，不会和上游冲突（前提是上游不会修改这些文件）。
• 优先合并上游的安全补丁：如果上游的修改是安全相关的，不管冲突多大，一定要把补丁合并进去，这是红线。可以先单独把安全补丁cherry-pick到定制分支，再处理其他同步。

• 把定制逻辑插件化/模块化：尽量不要直接修改上游的核心代码，而是通过上游提供的扩展接口来实现定制功能。比如定制浏览器，把自定义客服入口做成扩展插件，通过浏览器的插件API接入；定制ROM，把客户服务模块做成独立的APK，通过系统服务调用。这样上游更新只要接口没变，你的定制代码就不用改。
• 小步高频同步：别等上游更新了几十个版本再同步，最好每周或者每两周同步一次。每次处理的冲突少，更容易解决，也能及时跟上上游的安全更新。如果等几个月再同步，冲突会堆积成山，处理起来会崩溃。
• 自动化测试兜底：写一些核心定制功能的自动化测试用例，比如定制ROM的客服模块调用、浏览器的自定义按钮功能。每次同步完跑一遍测试，能快速发现被上游修改破坏的逻辑，避免上线后出问题。

总的来说，核心思路就是隔离上游和定制代码，用分支明确分工，小步同步减少冲突，再加上模块化的定制方式，就能把大型项目的同步成本降到最低。

内容的提问来源于stack exchange，提问作者Slaviro