
主版本表示不兼容的变更,次版本表示向后兼容的新增功能,修订号表示向后兼容的问题修复。三段之外还可以附加预发布标识与构建信息。
规则本身很简单,难的是团队是否一致执行。规则不执行,等于没有规则。
删除或重命名公开接口、修改参数含义、改变返回结构、提高最低运行环境要求,都属于破坏性变更。
判断时可以问一句:老用户按原文档调用,会不会失败。会失败就应升主版本,哪怕改动只有一行。
依赖版本写死,安全补丁进不来;写得太宽,可能引入不兼容更新。常见做法是限定主版本,允许次版本与修订号自动升级。
锁定文件要提交到仓库,确保不同环境安装到同一组版本。锁定文件不提交,是“本地能跑线上报错”的常见原因。
预发布标识用于标记尚未稳定的版本,便于测试渠道安装。正式发布前应验证从预发布升级到正式版的路径是否顺畅。
不要在正式环境使用预发布版本,除非已明确接受不稳定风险。
每次发布写清三件事:改了什么、是否影响兼容、升级时要注意什么。记录按版本号归档,便于回查。
发布记录不必长,但必须准确。含糊的“若干优化”没有参考价值。
人少时可以简化流程,但至少做到:版本号递增有依据、发布有记录、破坏性变更提前通知。
用一个固定模板的发布说明文件即可,不必引入复杂工具。关键是持续执行,而不是工具多先进。
一是修复了缺陷却升了主版本,导致用户误以为不兼容;二是新增功能只升修订号,让用户错过更新;三是长期停留在零点几版本,让使用者无法判断稳定性。
版本号是给使用者的承诺,随意变动会消耗信任。
语义化版本的价值在于让升级决策有依据。规则清楚、记录准确、变更诚实,依赖管理的大部分麻烦就能避免。
若项目对外提供插件接口,插件也应遵循同一版本规则,否则主版本升级时插件会大面积失效,使用者难以判断该升级哪一个。
这一条在小团队里尤其容易漏,接口一旦对外,改动成本会随时间成倍上升。