在开发过程中，我们经常需要对代码进行版本控制。Git 工具是目前最流行的版本控制工具之一。在 Git 中，当我们需要在代码分支之间进行切换时，有时会发现一些代码被暂时保存在了仓库中，这些暂存在仓库中的代码被称作“未提交的更改（stashes）”。
在 Git 中，使用 stash 命令可以将这些“未提交的更改”储存在仓库里。而在 npm 社区中，有一个非常有用的包 git-list-stashes，它提供了列出所有 stashes 的功能。本文将会向大家介绍 npm 包 git-list-stashes 的使用教程。
什么是 git-list-stashes？
git-list-stashes 是一个基于 Node.js 开发的 npm 包，它提供了一个用于列出 Git 仓库中所有 stashes 的命令行工具和 API。
如何安装 git-list-stashes？
使用 npm，我们可以很方便地安装 git-list-stashes：
npm install -g git-list-stashes
这样就可以全局安装 git-list-stashes 了。
如何使用 git-list-stashes？
一旦安装了 git-list-stashes，我们就可以在命令行中使用它了。使用 git-list-stashes 命令可以列出当前 Git 仓库的所有 stashes ，示例代码如下：
git-list-stashes
输出结果如下：
stash@{0}: On master: add new feature
stash@{1}: On dev: fix bug从输出结果中，我们可以看到 Git 仓库中当前有两个 stashes，一个保存在 master 分支上，另一个保存在 dev 分支上，在每个 stash 的右边，我们可以看到 stash 的名称（stash@{0} 和 stash@{1}），以及该 stash 所在的分支。
除了使用 git-list-stashes 命令，我们还可以在 Node.js 中使用 git-list-stashes API 来获取 Git 仓库中的所有 stashes。示例代码如下：
const GitListStashes = require('git-list-stashes');
GitListStashes.list().then((stashes) => {
console.log(stashes);
}).catch((err) => {
console.error(err);
});输出结果同使用 git-list-stashes 命令的结果一致。
结语
git-list-stashes 是一个非常实用的 npm 包，它为我们提供了列出所有 stashes 的功能。通过本文的学习，我们应该已经掌握了 npm 包 git-list-stashes 的基本使用方法，希望能够帮助大家更好的使用 Git 工具进行版本控制。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005581d81e8991b448d5479