二次开发规范:让外快项目也能长期维护
发布于 2026年11月19日 · 出海源码编辑部
大多数「源码改烂」的事故,源于没有在一开始设计 升级通道。推荐做法:
1. 分支策略
upstream:卖方原始代码,永不直接修改main:团队二开主线,通过 cherry-pick 吸收上游更新feature/*:功能分支,保护性合并
2. 代码隔离
- 用「插件/模块」方式承载二开功能,避免侵入核心文件
- 确需改动核心:加统一注释标记
// @custom <date> <who>,全局可检索
3. 依赖治理
二开引入的第三方包在 DEPENDS.md 登记名称、版本、用途与协议,防止许可证传染。
4. 数据库变更
每次变更写增量 SQL 并按版本号归档,保证「任意旧库 + 增量脚本 = 最新结构」。
5. 环境一致性
第一时间补 Docker Compose,本地/测试/生产同一镜像,杜绝「我机器上是好的」。