Semantic-release无法自动发布仓库已预标记版本至GitHub Releases

核心原因 #

Semantic-release 默认仅处理配置生效后产生的新版本标签，官方文档中提到的"支持现有标签"，指的是工具会识别仓库已有的标签来计算下一个版本号，而非自动回溯发布所有历史标签。

具体解决方案 #

1. 确保 GitHub Actions 权限足够 #

在你的 GitHub Actions 工作流文件中，添加写入仓库内容的权限，否则无法创建 Releases：

permissions:
  contents: write

2. 手动触发单个旧标签的发布 #

通过设置环境变量 SEMANTIC_RELEASE_VERSION，强制 semantic-release 发布指定的旧标签版本：

- name: 发布指定旧版本
  env:
    SEMANTIC_RELEASE_VERSION: v1.0.0  # 替换为你的旧标签版本号
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  run: npx semantic-release

3. 批量处理多个旧标签 #

如果有多个旧标签需要发布，可以编写简单脚本遍历仓库标签，逐个触发发布（注意避免频繁触发导致CI限制）：

# 示例脚本（可在CI中执行）
git fetch --tags
for tag in $(git tag -l "v*"); do
  SEMANTIC_RELEASE_VERSION=$tag npx semantic-release
done

4. 验证标签有效性 #

确保旧标签对应的提交未被删除或变基，semantic-release 需要读取标签关联的提交历史来生成 Release 描述内容。

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