一、先说结论
源码不加密、允许修改,不等于鼓励直接改核心代码。
判断标准很简单:改动会不会让下一次升级无法合并。会,就要换一种做法。
二、三类改动
第一类:扩展(推荐)
不改动原有文件,通过新增实现来满足需求:
- 新增业务域模块(不影响已有模块)
- 通过 SPI 扩展点接入自定义逻辑
- 新增前端页面 / 组件
- 新增定时任务、字典、参数配置
这类改动升级时几乎不会冲突。
第二类:配置(推荐)
能通过配置解决的不要改代码:
- 菜单、权限点、角色
- 字典与业务参数
- 支付渠道参数
- 装修模板与页面内容
- 通知模板
这类改动升级时完全无冲突。
第三类:修改核心(谨慎)
必须改 order / pay / stock / goods 等主链路代码时:
- 先评估能否用扩展点绕过
- 确实要改,逐文件记录(改动原因、期望行为、上游原实现)
- 升级时按记录逐项核对,而不是无脑接受某一方
三、不建议做的四件事
- 改表结构不写迁移脚本:升级后新环境建不出来
- 直接改第三方依赖:升级依赖时改动丢失
- 在 Controller 里写业务规则:后续无法被其它入口复用
- 把运营配置写死在代码里:每次调整都要发版
四、升级时的合并策略
| 改动类型 | 合并方式 |
|---|---|
| 新增文件 | 直接保留,无需处理 |
| 配置文件 | 以新版为基线,重新应用自己的键值 |
| 核心代码小改 | 逐处比对,按记录确认 |
| 核心代码大改 | 优先重构成扩展点,避免长期维护分叉 |
五、怎么判断改动量是否失控
一个可量化的信号:升级时需要人工比对的文件数。
- 10 个以内:正常
- 10~50 个:需要建立改动清单并持续维护
- 50 个以上:说明二次开发已经偏离主线,建议重新评估方案
六、授权范围内的边界
二次开发在版本授权范围内进行:
- 开源版(Apache-2.0):可自由修改、可再分发,需保留 LICENSE 与 NOTICE
- 商用版:授权到企业主体、不限域名,修改后的代码归属按合同约定
超出授权范围的转售、拆分授权、去除版权信息,不在允许范围内。