npm 包 standard-changelog 使用教程

阅读时长 3 分钟读完

前言

在开发前端项目的过程中,我们通常会使用一些工具来简化开发流程。其中,使用版本控制工具进行代码管理是必不可少的。为了更好地记录和展示项目版本更新的信息,我们可以借助一些工具自动生成 changelog 文件。而 standard-changelog 就是一个非常优秀的自动生成 changelog 的工具。

本文将详细介绍如何使用 standard-changelog 来生成 changelog 文件。

安装

使用 npm 安装 standard-changelog:

安装完成后,我们可以在项目中使用 standard-changelog 命令。

使用

初始化配置文件

在使用 standard-changelog 之前,需要先初始化配置文件。在项目根目录下执行以下命令:

该命令将会创建一个名为 CHANGELOG.md 的文件,并向其中写入当前项目的最近版本更新信息。

自动生成 changelog

在每次发布新版本时,我们可以使用以下命令生成新的 changelog:

该命令会读取所有 git commit 记录,并根据 commit 类型(feat、fix 等)自动分类编写相应的更新日志。然后将新的更新日志写入到 CHANGELOG.md 文件中。

自定义配置

standard-changelog 支持许多自定义配置项。例如,我们可以通过设置 preset 来指定 changelog 的风格和格式:

此命令将使用 Angular 风格的 changelog 格式。

更多自定义配置请参考 standard-changelog 官方文档

示范

以下是一个示例的 changelog(使用了 Angular 风格):

-- -------------------- ---- -------
-- -----------------
- ----- ------------

--- --------

- ---------- ------ --------------------------------------------------------------
- ------------- ------ --------------------------------------------------------------

--- --- -----

- ------------ -------------- --------------------------------------------------------------

总结

本文介绍了如何使用 standard-changelog 自动生成 changelog。通过使用该工具,我们可以更加高效地记录和展示项目版本更新的信息。

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

纠错
反馈