googleapis avatar

googleapis/release-please-action

2.5k 332 35
TypeScript Apache-2.0
创建于 6 年前 最后更新 1 个月前 +1 stars today

AI 综合评分

48 B 级
代码质量
44
文档质量
50
社区健康
46
项目活跃
52
创新性
42

项目简介

基于 Conventional Commits 的自动化版本发布 Action,智能管理版本与更新日志。

项目摘要

主题

让版本发布像提交代码一样自然,告别手动维护版本号和更新日志的繁琐。

核心分点总结

  1. Conventional Commits 驱动:自动解析符合规范的提交信息,智能决定版本号升级(major/minor/patch),无需人工判断。

  2. 全自动 CHANGELOG:根据提交历史自动生成结构化的更新日志,保持文档与代码同步,让每一次变更都有迹可循。

  3. GitHub Release 一键发布:自动创建 Release 标签、生成 Release Notes,并可触发后续 CI/CD 流程,实现交付闭环。

  4. 多语言支持:不仅限于 JavaScript/TypeScript,支持 Java、Python、Go 等多种语言的版本文件更新,适配各类项目。

  5. 灵活的配置选项:通过配置文件自定义版本策略、发布分支、标签前缀等,轻松适应不同团队的工作流。

行动指南

  1. 如果你的团队使用 Conventional Commits 规范,只需在 GitHub Actions 工作流中添加此 Action,即可实现版本自动化,无需额外工具。

  2. 初次使用,建议先在一个测试仓库中配置,观察版本号和 CHANGELOG 生成效果,再应用到生产项目,避免意外。

  3. 结合其他 CI 工具(如测试、构建),在 Release 触发时自动部署,形成完整的交付流水线,让发布真正“一键完成”。

金句总述

让每一次提交都成为版本演进的脚印,让发布回归代码本身。

故事性收尾

曾经,你需要在发布前夜手动整理更新日志,纠结版本号该升多少,然后在 GitHub 上小心翼翼地点击“发布”。现在,当你合入一个功能分支,CI 自动为你打上版本标签,生成精美的 Release Notes,世界清静了。你终于可以端起咖啡,看着自动化流水线从容地完成一切,然后继续写下一行代码。