npm 包 changelogx 使用教程

阅读时长 2 分钟读完

简介

changelogx 是一款 NPM 包,用于自动生成项目的 CHANGELOG。它可以帮助开发者在每次版本更新时更轻松地记录和维护一个清晰、规范的变更日志。

安装

使用 npm 安装 changelogx:

使用

以下是 changelogx 的常用命令:

初始化 changelog

该命令会在项目根目录下生成一个 CHANGELOG.md 文件,并将初始版本信息写入文件中。

添加新版本

  • version:新增版本号,例如 v1.0.0
  • date:新增版本日期,格式为 YYYY-MM-DD

执行该命令后,changelogx 会自动检索 git 提交记录,并将最新提交与上一次版本发布之间的所有 commit 记录添加到 CHANGELOG.md 文件中。

查看 CHANGELOG

该命令会在终端中显示当前项目的 CHANGELOG。

自动生成并发布新版本

  • version:新发布版本号,例如 v1.0.0
  • date:新发布版本日期,格式为 YYYY-MM-DD

执行该命令后,changelogx 会自动向 git 提交一个新版本的 tag,并将新版本的 CHANGELOG 更新到 CHANGELOG.md 文件中,最后推送代码至远程仓库。

示例

以下是一个简单的示例:

执行完这些命令后,你会在 GitHub 的 Release 页面中看到一个新的版本发布。同时,你也可以在项目根目录下查看到自动生成的 CHANGELOG.md 文件。

总结

使用 changelogx 能够帮助我们更好地维护和管理项目的变更日志。通过自动化的日志生成和记录,我们可以更加高效地协作开发,提高代码质量和可维护性。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/41036

纠错
反馈