GitHub Tag Action完全指南自动生成SemVer标签的终极解决方案【免费下载链接】github-tag-actionA Github Action to automatically bump and tag master, on merge, with the latest SemVer formatted version. Works on any platform.项目地址: https://gitcode.com/gh_mirrors/git/github-tag-actionGitHub Tag Action是一款强大的GitHub Action工具能够在代码合并到主分支时自动更新并标记最新的SemVer格式版本适用于任何平台。它通过分析提交消息来确定代码变更类型从而自动计算下一个语义化版本号极大简化了版本管理流程。 为什么需要自动版本标签在现代软件开发中版本管理是项目维护的关键环节。手动管理版本标签不仅耗时还容易出现人为错误。GitHub Tag Action通过以下方式解决这些问题自动化版本控制基于提交消息自动确定版本变更类型major、minor、patch符合SemVer规范严格遵循语义化版本标准减少人为错误消除手动标签创建过程中的失误提高团队协作效率统一版本管理流程让团队专注于代码开发 核心功能解析GitHub Tag Action提供了丰富的功能来满足不同项目的版本管理需求智能版本计算该工具使用semantic-release通过semver库处理版本号计算import { gte, inc, parse, ReleaseType, SemVer, valid } from semver;灵活的分支管理支持为不同类型的分支配置不同的版本策略发布分支默认master,main可通过release_branches自定义预发布分支通过pre_release_branches配置生成带有分支名后缀的预发布版本丰富的自定义选项可通过多种输入参数定制标签行为tag_prefix标签前缀默认为v如v1.0.0default_bump默认版本变更类型默认为patchcustom_tag自定义标签名称覆盖自动计算结果create_annotated_tag创建带注释的标签默认为轻量级标签 快速开始指南基本配置步骤在你的GitHub仓库中创建.github/workflows目录添加工作流文件如bump-version.yml内容如下name: Bump version on: push: branches: - master jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 - name: Bump version and push tag id: tag_version uses: mathieudutour/github-tag-actionv6.2 with: github_token: ${{ secrets.GITHUB_TOKEN }} - name: Create a GitHub release uses: ncipollo/release-actionv1 with: tag: ${{ steps.tag_version.outputs.new_tag }} name: Release ${{ steps.tag_version.outputs.new_tag }} body: ${{ steps.tag_version.outputs.changelog }}将代码推送到GitHub工作流将在每次合并到master分支时自动运行必要参数说明github_token必填参数用于授权标签操作通常使用${{ secrets.GITHUB_TOKEN }}release_branches指定哪些分支触发正式版本标签默认master,maindefault_bump当没有明确变更类型时的默认版本变更可选patch, minor, major 提交消息规范详解GitHub Tag Action使用Angular提交消息约定来确定版本变更类型。正确的提交消息格式是自动版本管理的关键提交类型与版本变更提交类型说明版本变更fix:修复bugPatch版本feat:新功能Minor版本BREAKING CHANGE:不兼容的API变更Major版本提交消息示例fix(pencil): stop graphite breaking when too much pressure applied→ 触发Patch版本更新feat(pencil): add graphiteWidth option→ 触发Minor版本更新perf(pencil): remove graphiteWidth option BREAKING CHANGE: The graphiteWidth option has been removed. The default graphite width of 10mm is always used for performance reasons.→ 触发Major版本更新⚙️ 高级配置选项自定义标签前缀默认标签前缀为v如果需要修改可设置tag_prefix参数with: github_token: ${{ secrets.GITHUB_TOKEN }} tag_prefix: version-这将生成类似version-1.2.3的标签。预发布版本配置对于开发分支可以配置预发布版本with: github_token: ${{ secrets.GITHUB_TOKEN }} pre_release_branches: dev,feature/* default_prerelease_bump: preminor这将为dev分支和feature/*分支生成类似v1.3.0-dev的预发布标签。自定义发布规则通过custom_release_rules参数定义自己的发布规则with: github_token: ${{ secrets.GITHUB_TOKEN }} custom_release_rules: hotfix:patch,docs:patch,refactor:minor 输出参数说明GitHub Tag Action提供多个输出参数可用于后续步骤如创建发布new_tag新生成的标签如v1.2.3new_version不带前缀的版本号如1.2.3previous_tag上一个标签如v1.1.0release_type版本变更类型major、minor、patch等changelog从上个版本到当前版本的变更日志 常见问题解决标签未生成如果工作流运行但未生成标签可能的原因提交消息不符合约定格式且未设置default_bump分支不在release_branches配置中没有新的提交与上一个标签相比版本计算不正确检查是否正确使用了提交消息约定特别是对于重大变更BREAKING CHANGE需要在提交消息体中明确说明。权限问题确保github_token具有足够权限通常使用默认的secrets.GITHUB_TOKEN即可但在某些情况下可能需要使用个人访问令牌。 相关资源官方文档docs/how-to-publish-new-version.md源码实现src/类型定义types/semantic.d.ts测试用例tests/ 总结GitHub Tag Action是一款功能强大的自动化版本管理工具通过遵循语义化版本规范和提交消息约定能够自动生成版本标签极大简化了开源项目和团队协作中的版本管理流程。无论是小型项目还是大型企业应用都能从中受益让开发者专注于代码质量而非版本号管理。要开始使用只需将仓库克隆到本地git clone https://gitcode.com/gh_mirrors/git/github-tag-action然后按照本文的配置指南在你的项目中设置工作流文件即可体验自动化版本管理的便利【免费下载链接】github-tag-actionA Github Action to automatically bump and tag master, on merge, with the latest SemVer formatted version. Works on any platform.项目地址: https://gitcode.com/gh_mirrors/git/github-tag-action创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考