跨平台项目多端差异场景下如何使用Git合理管理代码仓库

首选方案：单主干 + 代码分层隔离 + 特性开关 #

双独立主分支的核心问题是公共逻辑需要在两个分支反复同步，长期迭代很容易出现冲突、逻辑不一致的问题，维护成本会随迭代持续升高，这个方案可以完全规避该问题：

• 所有端共用唯一的main主干分支，通用逻辑的变更唯一合并入口就是main，确保公共逻辑只有一个可信源
• 代码层做目录拆分：单独划分/src/common目录存放全端通用的工具、核心业务模型等代码，/src/web存放Web端独有的功能实现，/src/native存放桌面端、移动端共用的独有逻辑，构建时按目标端选择对应目录编译，不会产出冗余代码
• 耦合度高的差异逻辑用特性开关控制：如果某段逻辑核心流程一致，仅端侧实现有差异，不用拆分两份代码，通过运行时/构建时的端判断走对应分支逻辑即可，不需要调整Git分支规则
• 功能开发统一用带端标识的特性分支，比如feat/web-shared、fix/native-offline，功能验证通过后直接合并回main即可

备选方案：多长期分支 + 公共分支同步规则 #

如果你的项目两端差异已经大到公共代码占比不足30%，共用主干会导致代码结构过度混乱，可以用该方案替代双独立主分支：

• 保留三个长期分支：main-common（公共逻辑专属分支）、main-web（Web端生产分支）、main-native（桌面/移动端生产分支）
• 所有公共逻辑的变更统一先提交到main-common，定期同步合并到两个端的生产分支，从流程上避免公共逻辑重复开发、版本不一致的问题
• 各端独有的功能变更直接提交到对应端的生产分支即可，不需要跨分支同步

方案选择参考 #

• 全端公共代码占比超过50%的项目，优先选单主干方案，长期维护成本最低
• 两端功能完全独立、几乎没有复用逻辑的项目，选多分支方案，避免单主干代码冗余度过高

内容的提问来源于stack exchange，提问作者Alessandro R.