前言

在软件开发中，规范的版本管理是团队协作的重要基础。本文将介绍如何使用Makefile配合Git标签实现版本号的自动递增管理，告别手动打Tag的繁琐操作。

实现效果

• 交互式选择版本升级类型（主版本/次版本/修订号）
• 支持直接指定版本号（CI/CD场景适用）
• 自动推送标签到远程仓库
• 兼容SemVer语义化版本规范

完整实现代码

.PHONY: tag
tag:
    @if [ -z "$$VERSION" ]; then \
        CURRENT_VERSION=$(shell git tag | grep '^v' | sort -V | tail -n 1 | sed 's/^v//'); \
        echo "当前版本: v$$CURRENT_VERSION"; \
        NEW_MAJOR=$$(echo $$CURRENT_VERSION | awk -F. '{print $$1 + 1 ".0.0"}'); \
        NEW_MINOR=$$(echo $$CURRENT_VERSION | awk -F. '{print $$1 "." $$2 + 1 ".0"}'); \
        NEW_PATCH=$$(echo $$CURRENT_VERSION | awk -F. '{print $$1 "." $$2 "." $$3 + 1}'); \
        echo "选择版本增量类型:"; \
        echo "1) 修订版本 (v$$NEW_PATCH)"; \
        echo "2) 次版本 (v$$NEW_MINOR)"; \
        echo "3) 主版本 (v$$NEW_MAJOR)"; \
        read -p "输入你的选择 (1-3, 默认是 1): " choice; \
        if [ -z "$$choice" ]; then \
            choice=1; \
        fi; \
        if [ "$$choice" -eq 1 ]; then \
            new_version="v$$NEW_PATCH"; \
        elif [ "$$choice" -eq 2 ]; then \
            new_version="v$$NEW_MINOR"; \
        elif [ "$$choice" -eq 3 ]; then \
            new_version="v$$NEW_MAJOR"; \
        else \
            echo "无效选择. 退出."; \
            exit 1; \
        fi; \
    else \
        new_version="$$VERSION"; \
        echo "使用指定版本: $$new_version"; \
    fi; \
    echo "创建新标签: $$new_version"; \
    git tag $$new_version; \
    echo "已创建新标签: $$new_version"; \
    echo "正在推送新标签到远程..."; \
    git push origin $$new_version; \
    echo "已推送新标签: $$new_version"

使用方法

1. 自动递增版本

直接运行命令：

# 交互式版本升级
make tag

# 直接指定版本号（适用于CI场景）
VERSION=v2.0.0 make tag

执行后会显示当前版本，并提供三个选项：

• 修订版本：增加最后一位数字（如 v1.0.0 → v1.0.1）
• 次版本：增加中间数字，最后一位归零（如 v1.0.1 → v1.1.0）
• 主版本：增加第一位数字，后两位归零（如 v1.1.0 → v2.0.0）

操作演示

make tag
当前版本: v1.2.3
选择版本增量类型:
1) 修订版本 (v1.2.4)
2) 次版本 (v1.3.0)
3) 主版本 (v2.0.0)
输入你的选择 (1-3, 默认是 1): 2

创建新标签: v1.3.0
已推送新标签: v1.3.0

实现原理

核心组件解析

1. 版本检测
   git tag | grep '^v' 筛选v开头的标签，sort -V进行版本号自然排序

2. 版本号切割
   使用awk按.分割版本号：

  # 主版本升级: 1.2.3 → 2.0.0
  awk -F. '{print $1 + 1 ".0.0"}'

  # 次版本升级: 1.2.3 → 1.3.0 
  awk -F. '{print $1 "." $2 + 1 ".0"}'

  # 修订号升级: 1.2.3 → 1.2.4
  awk -F. '{print $1 "." $2 "." $3 + 1}'</pre>

3. 异常处理

   • 通过-z "$$VERSION"判断是否手动指定版本

   • 使用exit 1处理非法输入

最佳实践建议

1. 版本命名规范
   推荐遵循语义化版本(SemVer)规范：

   • 主版本：不兼容的API修改

   • 次版本：向下兼容的功能新增

   • 修订号：向下兼容的问题修正

2. CI/CD集成
   可在GitHub Actions/GitLab CI中配置：

   release_job:
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v3
        - run: make tag VERSION=v$(next_version)</pre>

3. 版本校验增强
   可添加正则校验保证版本号格式：

  if [[ ! "$new_version" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
      echo "版本格式错误"
      exit 1
    fi</pre>

结语

通过这个Makefile实现，我们不仅规范了版本管理流程，还将复杂的版本计算逻辑封装成简单的make命令。这种自动化实践可以显著提升开发效率，特别适合需要频繁发布版本的敏捷开发团队。