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

シェル補完スクリプトを生成します。

# 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：セットアップ時にシェル設定ファイルの変更をスキップ
• VOLTA_FEATURE_PNPM：pnpm サポートを有効化