softprops/action-gh-release

这是什么？

核心功能

• 01为 tag 创建 GitHub Release，已存在时则更新该 Release。
• 02通过 glob 模式上传匹配的文件，并支持指定工作目录。
• 03可从文件读取 release 说明，或使用 GitHub 自动生成的更新日志。
• 04支持草稿、预发布以及 make_latest 等发布设置。
• 05可在 Linux、Windows 和 macOS 运行器上运行。
• 06输出 Release 的 URL、ID、上传地址以及已上传资源的信息。

适用场景

• 推送版本 tag 后，将 CI 构建出的二进制文件发布到 GitHub Release。
• 自动为每个 Release 附加校验和或打包后的压缩文件。
• 在打 tag 的构建中，从 changelog 文件或 GitHub 自动生成的说明生成 release 正文。

快速上手

1. 1

   在工作流文件中添加发布步骤

   uses: softprops/action-gh-release@v3
2. 2

   将发布步骤限定为标签推送，并在 files 中列出要上传的资源

使用前须知

• !仅能在 GitHub Actions 工作流中运行，不能作为独立工具使用。
• !若要为其他仓库创建发布，需要具有相应权限的个人访问令牌。

收录于专题

标签

常见问题

action-gh-release 是什么？

用于在 GitHub Actions 中创建 GitHub Release 并上传构建产物的 Action，支持 Linux、Windows 和 macOS。 action-gh-release 是一个 GitHub Action，用于为 tag 创建 GitHub Release 并上传构建产物。通常将它作为构建之后的一个步骤加入工作流，使流水线生成的二进制文件、压缩包或校验和自动附加到 Release 上。

action-gh-release 可以免费使用吗？用的什么许可证？

action-gh-release 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

action-gh-release 还在维护吗？

活跃维护中。action-gh-release 最近一次提交是在 2026年11月5日。

action-gh-release 适合用来做什么？

推送版本 tag 后，将 CI 构建出的二进制文件发布到 GitHub Release。 自动为每个 Release 附加校验和或打包后的压缩文件。 在打 tag 的构建中，从 changelog 文件或 GitHub 自动生成的说明生成 release 正文。

action-gh-release 怎么安装和运行？

在工作流文件中添加发布步骤: uses: softprops/action-gh-release@v3 将发布步骤限定为标签推送，并在 files 中列出要上传的资源

在哪里获取 action-gh-release？

源代码和安装说明在 GitHub 上：https://github.com/softprops/action-gh-release