出海源码

二次开发规范:让外快项目也能长期维护

发布于 2026年11月19日 · 出海源码编辑部

大多数「源码改烂」的事故,源于没有在一开始设计 升级通道。推荐做法:

1. 分支策略

  • upstream:卖方原始代码,永不直接修改
  • main:团队二开主线,通过 cherry-pick 吸收上游更新
  • feature/*:功能分支,保护性合并

2. 代码隔离

  • 用「插件/模块」方式承载二开功能,避免侵入核心文件
  • 确需改动核心:加统一注释标记 // @custom <date> <who>,全局可检索

3. 依赖治理

二开引入的第三方包在 DEPENDS.md 登记名称、版本、用途与协议,防止许可证传染。

4. 数据库变更

每次变更写增量 SQL 并按版本号归档,保证「任意旧库 + 增量脚本 = 最新结构」。

5. 环境一致性

第一时间补 Docker Compose,本地/测试/生产同一镜像,杜绝「我机器上是好的」。