如何自动将GitHub Action发布至GitHub Marketplace？

不需要手动操作——Marketplace同步Action版本是有规则的，只要满足条件就能自动触发，下面给你拆解具体逻辑和配置：

核心逻辑 #

GitHub Marketplace不会自动同步所有Release，它的触发条件是：

1. 仓库根目录必须有完整的action.yml（或action.yaml）配置文件，name、description、runs等核心字段不能缺失
2. 必须创建正式语义化版本标签（格式如vX.Y.Z，不带预发布后缀），且标签要关联到包含最新action.yml的提交
3. 第一次发布需要手动完成Marketplace的初始化（点击「Publish this Action to the GitHub Marketplace」并同意条款），后续版本更新完全自动化

针对你的两类工作流配置 #

1. 生产环境工作流（自动发布到Marketplace） #

在现有创建Release的流程上，补充/确认以下配置：

• 生成的标签必须是正式版本格式（如v3.1.2），不能带-rc这类预发布后缀
• 创建Release时，将prerelease设为false
• 确保工作流拉取完整代码（用actions/checkout@v4时加上fetch-depth: 0，避免浅克隆导致标签关联错误）

关键步骤示例：

- name: Checkout code
  uses: actions/checkout@v4
  with:
    fetch-depth: 0 # 拉取完整历史，确保标签关联正确提交

- name: Create Production Release
  uses: actions/create-release@v1
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  with:
    tag_name: ${{ steps.version.outputs.prod_tag }} # 格式如v3.1.2
    release_name: ${{ steps.version.outputs.prod_tag }}
    draft: false
    prerelease: false # 正式版本必须设为false

2. 预发布环境工作流（不发布到Marketplace） #

保持现有配置即可，只要做到两点：

• 标签带预发布后缀（如v3.1.2-rc.0）
• 创建Release时将prerelease设为true
  Marketplace会自动忽略这类预发布标签，不会同步到市场

排查要点 #

如果按配置操作后Marketplace仍未更新：

• 检查标签对应的提交：去仓库「Tags」页面查看标签关联的提交哈希，确认该提交里的action.yml是最新版本
• 确认第一次发布已经完成Marketplace初始化：如果从没手动点过发布按钮，必须先完成一次手动发布，后续才能自动同步
• 等待10-15分钟：Marketplace同步有延迟，不是实时生效的

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