如何用mikepenz/release-changelog-builder-action生成无标签变更日志

针对你遇到的日志被develop分支标签挤占的问题，可以通过以下几种方式解决：

• 精准指定版本对比范围
  默认配置会遍历所有标签，导致混入develop分支的标签。你需要明确限定main分支的版本区间，在Action配置中添加baseRef、fromTag和toTag参数：

  - name: Generate Changelog
    uses: mikepenz/release-changelog-builder-action@v4
    with:
      baseRef: main
      fromTag: v1.0.0 # 替换为main分支的上一个正式版本标签
      toTag: v1.1.0   # 替换为当前要发布的新版本标签
  

• 排除特定格式的无关标签
  如果develop分支的标签有统一格式（比如dev-v*），可以用excludeTagsRegex参数过滤掉这些标签：

  - name: Generate Changelog
    uses: mikepenz/release-changelog-builder-action@v4
    with:
      excludeTagsRegex: '^dev-v.*$'
  

• 自定义配置文件隐藏标签并按类别分组
  创建changelog-config.json文件，指定只按类别展示变更，不显示标签相关内容：

  {
    "categories": [
      {
        "title": "🚀 Features",
        "labels": ["feature", "enhancement"]
      },
      {
        "title": "🐛 Bug Fixes",
        "labels": ["bug", "fix"]
      }
    ],
    "showTags": false,
    "groupBy": "categories",
    "tagSeparator": ""
  }
  

  然后在Action中引用该配置：

  - name: Generate Changelog
    uses: mikepenz/release-changelog-builder-action@v4
    with:
      configuration: changelog-config.json
  

• 规范分支标签管理
  确保只有合并到main分支的变更才关联正式版本标签，develop分支的标签仅用于内部迭代，不纳入main分支的发布日志生成流程。

内容的提问来源于stack exchange，提问作者Donagh