volta uninstall
指定されたツールをアンインストールします。
使用法
bash
volta uninstall [オプション] <ツール[@バージョン]>
引数
<ツール[@バージョン]>
アンインストールするツール。以下の形式のいずれかを指定できます:
node
- Nodeの現在のデフォルトバージョンをアンインストールnode@version
- Nodeの特定のバージョンをアンインストールnpm
- npmの現在のデフォルトバージョンをアンインストールnpm@version
- npmの特定のバージョンをアンインストールyarn
- Yarnの現在のデフォルトバージョンをアンインストールyarn@version
- Yarnの特定のバージョンをアンインストールpnpm
- pnpmの現在のデフォルトバージョンをアンインストール(pnpmサポートが有効な場合)pnpm@version
- pnpmの特定のバージョンをアンインストール
オプション
--verbose
詳細な出力を有効にします。
--quiet
不要な出力を抑制します。
--help
このコマンドのヘルプ情報を表示します。
例
Nodeのアンインストール
bash
# 現在のデフォルトNodeバージョンをアンインストール
volta uninstall node
# 特定のNodeバージョンをアンインストール
volta uninstall node@16.14.2
# 複数のNodeバージョンをアンインストール
volta uninstall node@14.21.3
volta uninstall node@18.17.0
パッケージマネージャーのアンインストール
bash
# 現在のデフォルトnpmバージョンをアンインストール
volta uninstall npm
# 特定のnpmバージョンをアンインストール
volta uninstall npm@8.19.4
# Yarnをアンインストール
volta uninstall yarn@1.22.19
# pnpmをアンインストール(pnpmサポートが有効な場合)
volta uninstall pnpm@7.33.6
動作
デフォルトバージョンの処理
ツールのデフォルトバージョンをアンインストールする場合:
- 指定されたバージョンがアンインストールされます
- そのツールの他のバージョンがインストールされている場合、最新バージョンが新しいデフォルトになります
- そのツールの他のバージョンがない場合、デフォルトは設定されません
プロジェクト設定への影響
volta uninstall
は、プロジェクトのpackage.json
設定には影響しません。プロジェクトで固定されたバージョンをアンインストールしても、そのプロジェクトは引き続きそのバージョンを要求します(ただし利用できません)。
依存関係の確認
パッケージマネージャー(npm、yarn、pnpm)をアンインストールする前に、Voltaは以下を確認します:
- アンインストールしようとしているバージョンが現在アクティブなNodeバージョンにバンドルされていないか
- そのパッケージマネージャーに依存するプロジェクトがないか
エラー処理
ツールが見つからない場合
bash
volta uninstall node@99.99.99
# エラー: Node version 99.99.99 is not installed
デフォルトツールの競合
bash
# 現在アクティブなバージョンをアンインストールしようとした場合
volta uninstall node@18.17.0
# 警告: This will remove your default Node version. Continue? (y/N)
使用中のツールのアンインストール
bash
# 現在実行中のプロセスで使用されているツールをアンインストールしようとした場合
volta uninstall node@16.14.2
# 警告: Node 16.14.2 is currently in use. Continue? (y/N)
実践的な例
クリーンアップワークフロー
bash
# インストールされているすべてのツールを確認
volta list all
# 古いNodeバージョンをアンインストール
volta uninstall node@14.21.3
volta uninstall node@16.14.2
# 使わなくなったYarnバージョンをアンインストール
volta uninstall yarn@1.22.15
volta uninstall yarn@1.22.17
# 現在のデフォルトを確認
volta list
プロジェクト移行時のクリーンアップ
bash
# 古いプロジェクトで使用していたツールをアンインストール
volta uninstall node@12.22.12
volta uninstall npm@6.14.16
# 新しいツールセットをインストール
volta install node@18.17.0
volta install npm@9.8.0
CI/CDでの使用
bash
# ビルド後のクリーンアップ
volta uninstall node@${OLD_NODE_VERSION}
volta uninstall npm@${OLD_NPM_VERSION}
# または、すべてのツールを削除(極端な場合)
rm -rf ~/.volta/tools
関連コマンド
volta list
- インストールされているツールを確認volta install
- ツールを再インストールvolta pin
- プロジェクトのツールバージョンを固定volta which
- 現在使用されているツールのパスを確認
注意事項
バックアップの推奨
重要なツールをアンインストールする前に、現在の設定をバックアップすることを推奨します:
bash
# 現在の設定を記録
volta list all > volta-backup.txt
# プロジェクト設定を確認
find . -name "package.json" -exec grep -l "volta" {} \;
チーム環境での考慮事項
チーム開発環境では、他の開発者が使用している可能性のあるツールバージョンをアンインストールする前に確認してください:
bash
# プロジェクトで使用されているバージョンを確認
grep -r "volta" */package.json
ディスク容量の節約
定期的に不要なツールバージョンをアンインストールすることで、ディスク容量を節約できます:
bash
# ディスク使用量を確認
du -sh ~/.volta/tools
# 古いバージョンをアンインストール後
du -sh ~/.volta/tools