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"
関連コマンド
volta install
- ツールをインストールvolta uninstall
- ツールをアンインストールvolta pin
- プロジェクトのツールバージョンを固定volta which
- 現在使用されているツールのパスを確認