用途:为软件打上带标签的 GitHub Release,附带发布说明和可选构建产物,适用于标记稳定版本、发布库或应用新版本、为相关方编写发布说明、分发二进制或压缩包。
主要能力:按语义化版本(MAJOR.MINOR.PATCH)确定版本号;在 DESCRIPTION、package.json、Cargo.toml、pyproject.toml 等文件中更新版本;按新功能、修复、改进、破坏性变更分类编写变更日志并引用 issue/PR;创建并推送附注标签;用 GitHub CLI 创建发布,可附加产物、标记预发布;支持用 --generate-notes 从已合并 PR 自动生成说明,并通过 .github/release.yml 按标签配置分类。
使用方式:先确定版本号并更新项目文件版本,再编写发布说明,然后执行 git tag -a v1.1.0 -m "Release v1.1.0" 与 git push origin v1.1.0,最后用 gh release create v1.1.0 --title "v1.1.0" --notes-file CHANGELOG.md 创建发布;附加产物时在命令后列出文件,预发布加 --prerelease,自动生成说明用 --generate-notes。可用 gh release list 与 gh release view v1.1.0 验证。
限制与注意:需已认证 gh(gh auth login)并具备远程写权限;git push 不会推送标签,需显式推送;标签应指向版本更新提交,避免推送后删除重建;自动生成说明要求 PR 已合并且有标签,否则需手写;版本格式需统一。资料未提供具体收费、平台支持范围等信息。