Skip to content

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

動作

デフォルトバージョンの処理

ツールのデフォルトバージョンをアンインストールする場合:

  1. 指定されたバージョンがアンインストールされます
  2. そのツールの他のバージョンがインストールされている場合、最新バージョンが新しいデフォルトになります
  3. そのツールの他のバージョンがない場合、デフォルトは設定されません

プロジェクト設定への影響

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