借助 GitHub Actions + 语义化提交，实现自动版本发布

从手动打 tag 到自动识别版本，让发布流程更加智能和规范

在软件开发中，版本发布是一个重要但容易出错的环节。传统的流程往往包括：

手动更新版本号
手动打 tag
手动编写 Release Notes
手动上传构建产物

这不仅繁琐，还容易出错。

本文将介绍如何借助 GitHub Actions 和语义化提交，实现一套安全、自动、可维护的版本发布流程。

语义化提交：为自动发布打好基础

语义化提交（Semantic Commits）是一种结构化的提交信息规范，通过关键词标识更改类型：

feat: 添加新功能 → 触发 次版本号 增加
fix: 修复缺陷 → 触发 修订号 增加
BREAKING CHANGE: 破坏性变更 → 触发 主版本号 增加

例如：

1
2
3

feat: 添加用户登录功能
fix: 修复登录页面样式问题
BREAKING CHANGE: 重构用户认证系统

配合工具或脚本，就能自动推断版本号。

自动识别版本号与标签

我们使用 commit message 中的 [release/v1.2.3] 格式来明确版本发布意图：

- name: Determine Release Type
  id: determine-release
  run: |
    if [[ "${{ github.event.head_commit.message }}" =~ \[release\/v([0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9]+)?)\] ]]; then
      echo "RELEASE_TYPE=release" >> $GITHUB_OUTPUT
      echo "TAG_NAME=v${BASH_REMATCH[1]}" >> $GITHUB_OUTPUT
    else
      echo "RELEASE_TYPE=ci" >> $GITHUB_OUTPUT
      echo "TAG_NAME=ci-${GITHUB_RUN_NUMBER}" >> $GITHUB_OUTPUT
    fi

这样可以区分正式版本（用于发布）与 CI 版本（用于预览或测试）。

自动创建 Release 并上传构建产物

借助 GitHub CLI，可以在 CI 中创建 Release 并上传构建产物：

- name: Create Release
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
    RELEASE_TYPE: ${{ steps.determine-release.outputs.RELEASE_TYPE }}
  run: |
    gh release create "${{ steps.determine-release.outputs.TAG_NAME }}" \
      --title="${{ github.repository }} ${{ steps.determine-release.outputs.TAG_NAME }}" \
      --generate-notes \
      $([[ "$RELEASE_TYPE" == "ci" ]] && echo "--prerelease") \
      ./release.tar.gz

优势：

自动生成 Release Notes
支持 CI 预发布 vs 正式版本区分
支持上传多个构建产物

与自动部署流程集成

配合部署步骤，可以实现完整的“一键发布”效果：

deploy:
  needs: build
  runs-on: ubuntu-latest
  if: ${{ needs.build.outputs.release_type == 'release' }}
  steps:
    - name: Download Release
      uses: robinraju/release-downloader@v1
      with:
        repository: ${{ github.repository }}
        tag: ${{ needs.build.outputs.tag_name }}
        fileName: release.tar.gz