CLI 命令

Volta 提供丰富的命令行命令集来帮助您管理 JavaScript 工具链。

核心命令

volta install

在您的工具链中安装工具。

# 安装最新的 Node.js LTS
volta install node

# 安装特定版本的 Node.js
volta install node@16.14.2

# 安装最新的 npm
volta install npm

# 安装特定版本的 yarn
volta install yarn@1.22.19

# 全局安装包
volta install typescript
volta install @vue/cli

选项：

• --verbose：启用详细诊断
• --quiet：防止不必要的输出

volta uninstall

从您的工具链中卸载工具。

# 卸载 Node.js
volta uninstall node

# 卸载 npm
volta uninstall npm

# 卸载包
volta uninstall typescript

volta pin

将工具固定到您项目的 package.json 中。

# 固定 Node.js
volta pin node@16.14.2

# 固定 npm
volta pin npm@8.5.0

volta list

列出您工具链中可用的工具。

# 列出所有工具
volta list all

# 列出已安装的 Node.js 版本
volta list node

# 列出已安装的包管理器
volta list npm
volta list yarn

# 列出已安装的包
volta list packages

volta which

显示 Volta 将使用的指定工具的路径。

volta which node
volta which npm
volta which typescript

volta run

使用自定义工具版本运行命令。

# 使用特定的 Node.js 版本运行
volta run --node 14 node index.js

# 使用特定的 npm 版本运行
volta run --npm 6 npm install

# 同时使用自定义的 Node.js 和 npm
volta run --node 14 --npm 6 npm install

附加命令

volta completions

生成 shell 补全脚本。

# 生成 bash 补全
volta completions bash > volta.bash

# 生成 zsh 补全
volta completions zsh > _volta

# 生成 fish 补全
volta completions fish > volta.fish

volta setup

在您的环境中配置 Volta。

# 使用默认设置设置 Volta
volta setup

# 设置 volta 而不修改配置文件
VOLTA_SKIP_SETUP=1 volta setup

volta help

显示 Volta 命令的帮助。

# 常规帮助
volta help

# 特定命令的帮助
volta help install
volta help pin

退出代码

Volta 命令返回以下退出代码：

• 0：成功
• 1：通用错误
• 2：命令行参数错误
• 更高数字：特定于命令的错误

环境变量

这些环境变量在运行命令时影响 Volta 的行为：

• VOLTA_HOME：Volta 存储数据的目录
• VOLTA_LOGLEVEL：日志详细程度（error、warn、info、verbose、debug）
• VOLTA_SKIP_SETUP：在设置期间跳过修改 shell 配置文件
• VOLTA_FEATURE_PNPM：启用 pnpm 支持