Skip to content

volta list

インストールされているツールまたは利用可能なツールを表示します。

使用法

bash
volta list [オプション] [ツール]

引数

[ツール]

リストするツールを指定します。省略した場合、現在インストールされているツールを表示します。

  • all - すべてのインストール済みツール
  • node - Nodeバージョン
  • npm - npmバージョン
  • yarn - Yarnバージョン
  • pnpm - pnpmバージョン(pnpmサポートが有効な場合)

オプション

--current, -c

現在アクティブなツールバージョンのみを表示します。

--verbose

詳細な出力を有効にします。

--quiet

不要な出力を抑制します。

--help

このコマンドのヘルプ情報を表示します。

基本的な使用法

bash
# すべてのインストール済みツールを表示
volta list

# すべてのツール(インストール済み、デフォルト設定を含む)を表示
volta list all

# 現在アクティブなツールのみを表示
volta list --current

特定のツールのリスト

bash
# インストールされているNodeバージョンを表示
volta list node

# インストールされているnpmバージョンを表示
volta list npm

# インストールされているYarnバージョンを表示
volta list yarn

# インストールされているpnpmバージョンを表示(pnpmサポートが有効な場合)
volta list pnpm

出力形式

デフォルト出力

bash
$ volta list
 Currently active tools:

    Node: v18.17.0 (default)
    npm: v9.8.0 (default)
    Yarn: v1.22.19 (default)

See options for more detailed reports.

詳細出力

bash
$ volta list all
 User toolchain:

    Node runtimes:
        v16.14.2
        v18.17.0 (default)
        v20.5.0

    Package managers:
        npm:
            v8.19.4 (bundled with node v16.14.2)
            v9.8.0 (default)
            v10.0.0

        Yarn:
            v1.22.15
            v1.22.19 (default)

        pnpm:
            v7.33.6
            v8.6.0 (default)

現在のツール出力

bash
$ volta list --current
Node: v18.17.0
npm: v9.8.0
Yarn: v1.22.19

実践的な例

開発環境の確認

bash
# プロジェクトディレクトリで現在のツールを確認
cd my-project
volta list --current

# システム全体でインストールされているツールを確認
volta list all

ツールバージョンの棚卸し

bash
# すべてのNodeバージョンを確認
volta list node

# 出力例:
 Node runtimes:
    v14.21.3
    v16.14.2
    v18.17.0 (default)
    v20.5.0

# 古いバージョンをアンインストールする判断材料として使用
volta uninstall node@14.21.3

プロジェクト間の違いを確認

bash
# プロジェクトAで確認
cd /path/to/project-a
volta list --current
# Node: v16.14.2, npm: v8.19.4

# プロジェクトBで確認  
cd /path/to/project-b
volta list --current
# Node: v18.17.0, npm: v9.8.0

CI/CDでの活用

環境確認スクリプト

bash
#!/bin/bash
echo "=== Volta ツール確認 ==="
volta list --current

echo "=== インストール済みツール ==="
volta list all

echo "=== プロジェクト設定 ==="
if [ -f package.json ]; then
  grep -A 10 '"volta"' package.json || echo "プロジェクト設定なし"
fi

GitHub Actions

yaml
name: Environment Check
on: [push, pull_request]

jobs:
  check-env:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Install Volta
        run: |
          curl https://get.volta.sh | bash
          echo "$HOME/.volta/bin" >> $GITHUB_PATH
      
      - name: Show Volta tools
        run: |
          volta list --current
          volta list all

フィルタリングとパイプライン

特定情報の抽出

bash
# 現在のNodeバージョンのみを取得
volta list --current | grep "Node:" | cut -d' ' -f2

# デフォルトツールの一覧をファイルに保存
volta list --current > current-tools.txt

# 特定のツールがインストールされているかチェック
volta list node | grep -q "v18.17.0" && echo "Node 18.17.0 がインストール済み"

JSON形式での出力(カスタムスクリプト)

bash
#!/bin/bash
# volta-list-json.sh
echo "{"
echo "  \"current\": {"
current=$(volta list --current)
node_version=$(echo "$current" | grep "Node:" | cut -d' ' -f2)
npm_version=$(echo "$current" | grep "npm:" | cut -d' ' -f2)
yarn_version=$(echo "$current" | grep "Yarn:" | cut -d' ' -f2)

echo "    \"node\": \"$node_version\","
echo "    \"npm\": \"$npm_version\","
echo "    \"yarn\": \"$yarn_version\""
echo "  }"
echo "}"

出力のカスタマイズ

簡潔な表示

bash
# シンプルなバージョン表示
volta list --current --quiet

# カスタムフォーマット
volta list --current | sed 's/^/  /'

詳細な分析

bash
# ディスク使用量と組み合わせ
echo "=== Voltaツール使用量 ==="
volta list all
echo ""
echo "=== ディスク使用量 ==="
du -sh ~/.volta/tools/*/*

トラブルシューティング

空の出力

bash
volta list
# 何も表示されない場合

# Voltaが正しくインストールされているか確認
volta --version

# ツールをインストール
volta install node
volta list

不正確な情報

bash
# キャッシュをクリア
rm -rf ~/.volta/cache

# Voltaを再初期化
volta setup

# 再度確認
volta list all

形式の問題

bash
# ロケール設定を確認
echo $LANG

# 英語環境で実行
LANG=en_US.UTF-8 volta list

ベストプラクティス

定期的な確認

bash
# 週次チェックスクリプト
#!/bin/bash
echo "=== $(date) ==="
volta list all
echo ""
echo "=== ディスク使用量 ==="
du -sh ~/.volta
echo ""

チーム間での情報共有

bash
# チーム用のツール情報を出力
volta list all > team-volta-status.txt
git add team-volta-status.txt
git commit -m "Update team Volta tool status"

関連コマンド