前言
在开发过程中，我们经常需要跟踪项目的变更。而 GitHub 的 changelog 是很好的记录变更的方式之一。然而，在某些情况下，我们可能无法访问 GitHub 或者想要将 changelog 保存在本地。这时，使用 offline-github-changelog 可以轻松地实现这一功能。
offline-github-changelog 是一个基于 Node.js 的命令行工具，可以从 GitHub API 中获取指定仓库的 changelog，并将其保存为 Markdown 格式的文件。
在本文中，我们将详细介绍如何使用 offline-github-changelog 工具。
安装
使用 npm 可以方便地安装 offline-github-changelog：
npm install -g offline-github-changelog
此处 -g 参数表示全局安装，可在任何目录下使用 offline-github-changelog 命令。
使用方法
使用 offline-github-changelog 需要提供 GitHub 仓库的信息，包括用户名、仓库名、起止版本号等。
获取 GitHub API Token
GitHub API 的使用需要提供 Token，因此我们需要先获取一个 Token。具体操作如下：
- 登录 GitHub。
- 点击右上角头像，选择 Settings。
- 选择 Developer settings -> Personal access tokens。
- 点击 Generate new token。
- 勾选 repo 和 read:user 权限（repo 权限用于访问仓库，read:user 权限用于访问用户信息）。
- 点击 Generate token。
生成的 Token 要保存好，因为 GitHub 只会显示一次。
使用 offline-github-changelog
使用命令行进入到要保存 changelog 的目录下，执行如下命令：
offline-github-changelog <user> <repo> <start version> <end version> -t <token> -f <filename>
其中：
<user>: GitHub 用户名；<repo>: 仓库名；<start version>: 起始版本号（可选，不指定则默认获取第一个 release）；<end version>: 终止版本号（可选，不指定则默认获取最新 release）；-t <token>: GitHub API Token；-f <filename>: 保存 changelog 的文件名（可选，不指定则默认为CHANGELOG.md）。
例如，获取 vue.js 仓库的 changelog 并将其保存为 my-changelog.md 文件，可以执行如下命令：
offline-github-changelog vuejs vue v2.1.0 v3.0.0 -t <token> -f my-changelog.md
总结
通过本文的介绍，我们了解了如何使用 offline-github-changelog 工具获取 GitHub 仓库的 changelog，并将其保存为本地文件。同时，我们还介绍了如何获取 GitHub API Token。
对于开发者来说，了解这些工具的使用方法可以提升开发效率和代码管理能力。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/45754