什么是 Changelogs？
Changelogs 是一个记录软件版本信息的历史的文档，它精确记录了软件从最初版本开始的每个版本的新增、修改、优化和已知问题等。Changelogs 的存在可以方便用户了解软件是否有更新或者在开发过程中发现问题。npm 包 changelogs 则是 npm 仓库中一些包的版本历史记录，可以帮助开发者更好地了解每个版本的变化。
如何查看 npm 包 changelogs？
在 npm 仓库中查看 npm 包 changelogs 的方法很简单。我们可以在 npm 上找到该包，然后找到“Changelog”部分。如下图所示：
在这里，可以通过不同的方式来查看 changelogs，比如：
阅读原始 markdown 文件
可以查看 npm 包中的 changelog.md 文件来了解该包的所有版本和变更信息。该原始文件通常包含每个版本的大概描述，列表题目和变动细节等信息。我们可以通过在 npm 包根目录下查找 CHANGELOG.md 文件或者在 GitHub 项目中查看它，如下图所示：
查看 npm Web 页面
通过“Changelog”部分提供的链接，我们可以进入 npm Web 页面，并查看特定包或组织的 changelog。该页面可以显示包的各个版本，并按时间顺序列出每个版本的变更摘要。我们可以在此查看所有版本的变更情况，并通过详细说明了解每个版本的变化。如下图所示：
如何更新 npm 包的 changelog？
对于开发者来说，更新 npm 包的 changelog 是一项重要的任务。在开发过程中，我们需要记录软件的版本信息并将其提交到 changelog 中，以便用户了解软件的变化和改进。在更新 changelog 上，我们可以使用工具自动生成 changelog 的概述信息，然后根据需要修改和完善这些信息。
使用 Standard-version 更新 changelog
Standard-version 是一个自动生成版本号和 changelog 的 CLI 工具，它遵循 SemVer 规范和版本控制器格式。该工具会根据 git 历史记录生成 changelog，并自动为您的软件生成新的版本号。我们可以使用以下命令来安装 Standard-version：
npm install --save-dev standard-version
安装成功之后，我们可以在项目根目录下运行以下命令来生成 changelog：
npx standard-version
它将生成类似于以下内容的 changelog：
-- -------------------- ---- ------- -- ----- ------------ --- -------- - --- --- ------- ------ --- --- ----- - --- --- -- ------- ------ -- ----- ------------ ------- -------
然后您可以将 changelog.md 文件包含在版本发布中，并将其提交到 npm 仓库中。
总结
在本文中，我们介绍了 npm 包 changelogs 的概念和使用方法，以及如何更新它们。通过查看 changelogs，开发者可以更好地了解软件的版本历史和变更，从而确保项目的持续发展。当然，如果您希望更好地掌握 changelogs，可以通过查看 npm 包库中的其他包的 changelogs，来了解当前的最佳实践和发展趋势。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60058ba681e8991b448ed3d8