如何使用 Volta

183 阅读2分钟

Volta 是一个轻量级的 JavaScript 工具链管理器,可以快速切换和管理 Node.js 以及相关工具的版本。本文将介绍如何安装、配置 Volta,并在项目中灵活使用。


1. 安装 Volta

从官方站点安装

  1. 前往 Volta Releases 下载最新版本。
  2. 按照操作系统的指引安装。

脚本安装(推荐)

在终端运行以下命令:

curl https://get.volta.sh | bash

安装完成后,关闭并重新打开终端以加载环境变量。


2. 验证安装

运行以下命令,检查 Volta 是否安装成功:

volta --version

成功时会显示版本号。


3. 使用 Volta 管理 Node.js

检查当前环境

使用以下命令查看 Volta 当前管理的工具版本:

volta list node

注意:如果在安装 Volta 前已全局安装 Node.js,Volta 无法管理这些版本。

安装和切换 Node.js 版本

安装指定版本

volta install node@18.17.1

安装完成后,该版本会立即成为全局默认版本。

查看已安装的 Node.js 版本

volta list node

全局切换版本

volta install node@16.20.0

此版本将成为新的全局默认版本。


4. 为项目指定 Node.js 版本

进入项目根目录后,运行以下命令:

volta pin node@16.20.0

此命令会在项目目录生成一个 package.json 中添加如下信息:

"volta": {
  "node": "16.20.0"
}

每次进入该项目目录时,Volta 会自动切换到指定版本的 Node.js。


5. 安装和管理 NPM/Yarn

安装指定版本

volta install npm@9.8.0
volta install yarn@1.22.19

查看已安装版本

volta list npm
volta list yarn

为项目指定 NPM 或 Yarn 版本

volta pin npm@7.21.0
volta pin yarn@1.22.15

6. 清理未使用的版本

可以通过以下命令清理未使用的工具版本,释放存储空间:

volta uninstall node@16.20.0

7. 常见问题

Volta 无法检测之前安装的 Node.js

如果你在安装 Volta 前已经安装了 Node.js,Volta 无法直接管理这些版本。建议通过 Volta 重新安装。

修改全局默认版本后不起作用

请确保修改后运行的命令已加载正确的环境变量,必要时重启终端。


8. 总结

Volta 是一个强大的工具链管理器,可以帮助开发者轻松管理不同版本的 Node.js、NPM 和 Yarn,并提供项目级别的灵活配置。通过本文的指导,你应该已经掌握了如何安装和使用 Volta,开始管理你的开发环境吧!