多仓库场景下merge/cherry-pick时如何处理UUID避免重复？

场景说明 #

我们拥有3个项目仓库：main-prj、second-prj和third-prj，95%内容一致，仅部分名称和UUID存在差异。所有功能新增和修改仅在main-prj中进行，之后需要将变更合并（merge）或拣选（cherry-pick）至另外两个仓库。

问题描述 #

在main-prj中新增了一个UUID：myUuid = '2e9618f0-e529-4d22-810b-3dfd62f5c4bd'，同步到其他仓库时必须保证各仓库UUID不重复。想了解：是否可以让这个UUID在合并时触发冲突，以便手动修改？这种做法是否属于最佳实践？

关于触发冲突的可行性 #

可以通过刻意操作让UUID在合并时触发冲突，具体方式比如：

• 在second-prj和third-prj的对应代码位置，预先保留一个与main-prj新增UUID不同的占位符（例如myUuid = 'REPLACE_WITH_THIS_REPO_UUID'）。当从main-prj合并/拣选包含新UUID的提交时，Git会因该行内容不一致触发冲突，此时即可手动替换为当前仓库的专属UUID。

这种做法是否属于最佳实践？ #

不属于，原因如下：

• 重复的冲突处理会增加人工成本，效率低下，且容易因疏忽导致UUID重复；
• Git的冲突机制本是为处理意外代码分歧设计，刻意制造冲突违背其设计初衷，会让工作流变得生硬且不规范；
• 依赖人工判断的环节越多，出错概率越高，不利于长期维护。

更优的替代方案 #

• 抽离专属配置：将UUID这类仓库独有的配置项，单独放到一个独立文件（比如local-config.js），并将该文件加入.gitignore。主仓库仅维护通用代码逻辑，同步时不会涉及专属配置的冲突，各仓库自行维护自己的配置文件即可；
• 模板化配置生成：如果需要同步配置结构，可以在主仓库维护配置模板文件（比如config.template.js），每个仓库通过脚本自动将模板中的占位符替换为自身的UUID，无需手动修改；
• 自动化同步脚本：编写Shell或Python脚本，在从main-prj同步代码后，自动识别新增的UUID字段，并替换为当前仓库的专属值，全程自动化处理，避免人工干预。

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