掌握SemVer版本管理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-actionGitHub Tag Action是一款强大的自动化工具能够在代码合并到主分支时自动生成符合SemVer规范的版本标签帮助开发者实现专业的版本管理。无论是小型项目还是大型应用这款工具都能让你的版本控制流程更加高效和规范。 什么是SemVer版本管理SemVer语义化版本是一种版本编号规范它定义了版本号的格式为主版本号.次版本号.修订号如1.0.0。每个数字代表不同的含义主版本号当进行不兼容的API更改时增加次版本号当添加功能但保持向后兼容时增加修订号当进行向后兼容的问题修复时增加GitHub Tag Action通过分析提交信息自动确定版本号的变更确保你的项目版本始终符合SemVer规范。 GitHub Tag Action的核心优势自动化版本管理无需手动计算和创建版本标签工具会根据提交信息自动完成跨平台支持可在任何操作系统上运行包括Windows、macOS和Linux高度可定制支持自定义标签前缀、发布规则和分支过滤等功能与GitHub生态完美集成可直接在GitHub Actions工作流中使用与其他Action无缝协作 快速开始安装与配置要使用GitHub Tag Action首先需要将其添加到你的GitHub Actions工作流文件中。以下是一个基本的配置示例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 }}这个配置会在代码推送到master分支时自动运行生成新版本标签并创建GitHub Release。 关键配置选项详解GitHub Tag Action提供了丰富的配置选项让你可以根据项目需求定制版本管理策略基础设置github_token必填项用于授权操作仓库通常使用${{ secrets.GITHUB_TOKEN }}default_bump默认的版本变更类型可选值为patch默认、minor或majortag_prefix标签前缀默认为v生成的标签格式如v1.0.0分支管理release_branches指定哪些分支会生成正式版本标签默认为master,mainpre_release_branches指定哪些分支会生成预发布版本标签自定义规则custom_release_rules自定义发布规则格式为keyword:release_type:changelog_sectioncreate_annotated_tag是否创建带注释的标签默认为false 提交信息规范如何触发版本更新GitHub Tag Action使用语义化提交信息来确定版本变更类型。遵循以下规范工具将自动识别并应用相应的版本更新提交信息示例版本变更类型fix(pencil): stop graphite breaking when too much pressure applied修订版本Patchfeat(pencil): add graphiteWidth option次版本Minorperf(pencil): remove graphiteWidth optionBREAKING CHANGE: The graphiteWidth option has been removed.主版本Major通过在提交信息中使用fix、feat等关键词结合可选的BREAKING CHANGE说明工具可以准确判断应该进行哪种类型的版本更新。 输出参数集成到你的工作流GitHub Tag Action提供了多个输出参数方便你在后续步骤中使用new_tag新生成的标签值new_version不带前缀的新版本号previous_tag上一个标签值changelog自上一个标签以来的变更日志这些参数可以通过${{ steps.tag_version.outputs.new_tag }}这样的语法在工作流中引用实现自动化的版本发布流程。️ 高级用法定制你的版本策略预发布版本管理对于开发中的功能你可以配置预发布版本with: pre_release_branches: dev,feature/* default_prerelease_bump: preminor append_to_pre_release_tag: beta这将在dev分支和feature/*分支上生成类似v1.1.0-beta.dev.123的预发布标签。自定义标签前缀如果你不希望使用默认的v前缀可以自定义with: tag_prefix: release-这将生成类似release-1.0.0的标签。调试模式在配置新的版本策略时可以使用调试模式with: dry_run: true这将只计算新版本和变更日志而不会实际创建标签方便测试和调整。 项目结构与源码GitHub Tag Action的核心代码位于以下文件主逻辑src/action.tsGitHub API交互src/github.ts工具函数src/utils.ts类型定义types/semantic.d.ts这些文件实现了从版本计算到标签创建的完整流程遵循TypeScript最佳实践确保代码的可维护性和扩展性。 如何获取项目要在你的项目中使用GitHub Tag Action无需手动下载只需在工作流文件中引用即可。如果你想查看源码或贡献代码可以通过以下命令克隆仓库git clone https://gitcode.com/gh_mirrors/git/github-tag-action 总结GitHub Tag Action为项目提供了专业、自动化的SemVer版本管理解决方案。通过遵循语义化提交规范结合灵活的配置选项你可以轻松实现版本控制的标准化和自动化让团队更专注于代码开发而非版本管理。无论是小型开源项目还是大型企业应用这款工具都能帮助你建立清晰、可靠的版本管理流程。开始使用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），仅供参考