本指南暂不包含
fetch
,pull
,push
,clone
等 Git 版本库操作和CI/CD
工作流搭建等
一、版本规范:
结合 semver 语义化版本以及 software release life cycle 软件发布生命周期两块概念,约定 git tag
标签规则
格式命名
基础版本格式:
<主版本号>.<次版本号>.<修订版本号>
三位数字用 .
连接组成一个版本号,如 1.0.0
版本号数字递增规则:
- 主版本号:对代码进行了不向前兼容的修改
- 次版本号:向前兼容的修改,只是新增了功能
- 修订版本号:向前兼容的故障修复、需求细节变更
细化版本格式:
在原来x.y.z
基础版本号后面添加软件生命周期
作为先行版本号,以及添加附加信息(编译信息、时间戳、序号等)
来进一步细化控制版本 - 先行版本号:表示在正式版之前发布的版本,并非稳定而且可能无法满足预期的兼容性需求,格式是标注在修订版之后,先加上一个连接号
-
, 再加上一连串以句点分隔的标识符来修饰, 。范例:1.0.0-alpha.1
、1.0.0-rc.22
、1.0.0-beta.33
…常见的先行版本
alpha
: 内测版本,通常提测至测试部beta
: 公测版本,通常可以面向用户全量或者灰度发布rc
: 即Release candiate
,正式版本的候选版本,用作预发布
注:这些版本的发布可能需要团队的工作流程以及部署环境的隔离去支撑
- 版本编译信息: 可以在修订版或先行版本号之后,先加上一个加号再加上一连串以句点分隔的标识符来修饰。范例:
1.0.0+jested
、1.0.0-alpha+001
、1.0.0-rc+20130313144700
、1.0.0-beta+exp.sha.5114f85
、1.0.0-next+0
…
创建标签
1 | # 创建 |
常用命令行:
1 | # < xxx > just means variable |