使用semantic-release的GitHub Actions工作流无报错但无法生成版本

从提供的日志来看，semantic-release在执行到analyzeCommits步骤后直接终止，未触发版本发布，且输出new_release_published = false。结合本地执行npx semantic-release --no-ci正常的情况，问题集中在CI环境的配置细节上，以下是针对性解决方案：

解决方案 #

1. 拉取完整Git历史 #

默认actions/checkout@v3仅拉取最新一次提交，semantic-release需要完整历史分析版本变更。修改checkout步骤：

- name: Checkout
  uses: actions/checkout@v3
  with:
    fetch-depth: 0

2. 配置CI环境Git用户信息 #

CI环境未配置Git用户时，semantic-release无法提交变更。添加Git配置步骤：

- name: Configure Git User
  run: |
    git config --global user.name "GitHub Actions"
    git config --global user.email "actions@github.com"

3. 简化插件配置 #

@semantic-release/commit-analyzer等属于semantic-release核心插件，无需额外声明，可简化配置避免版本冲突：

- name: Semantic Release
  uses: cycjimmy/semantic-release-action@v4
  id: semantic
  with:
    extra_plugins: |
      conventional-changelog-conventionalcommits
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

4. 显式设置权限 #

确保GITHUB_TOKEN拥有足够操作权限，在job层级添加权限配置：

jobs:
  release:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      packages: write
    steps:
      # ...其他步骤

5. 验证提交格式合法性 #

检查13个提交是否全部符合conventional commits规范，若存在不符合的提交，semantic-release会判定无版本需要发布。本地执行npx semantic-release --dry-run可查看具体分析结果。

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