Windows + Voltaで古いNode.jsバージョンを削除する方法

2025年10月10日

Rust製の高速ツールチェーンマネージャー Volta を使ってNode.jsを管理していると、複数のバージョンが溜まっていくことがあります。しかし、Voltaには現時点（2025年10月時点）で volta uninstall node@xx コマンドが未対応という制限があります。

この記事では、Windows環境でVoltaを使っている場合に、古いNode.jsバージョンを安全に削除する方法を紹介します。

🚧 まず結論：VoltaはNodeのアンインストールをサポートしていない

Voltaでは、npmやyarnなどのツールはvolta uninstallで削除できますが、Node.js本体は対象外です。実際に試すと以下のようなエラーになります：

volta uninstall node@22.16.0
error: Uninstalling node is not supported yet.

したがって、Node.jsを削除するには手動で該当フォルダを削除する必要があります。

🗂 Node.jsが保存されているフォルダ

Voltaが管理しているNode.jsの実体は、次のパスに格納されています：

%LOCALAPPDATA%\Volta\tools\image\node\

例：

C:\Users\ユーザー名\AppData\Local\Volta\tools\image\node\22.16.0\

このディレクトリ内に、バージョンごとのNode.jsが保存されています。

🔧 削除する前に：現在のNode.jsバージョンを確認

まず、現在使用中（default）のNode.jsを確認します。

volta list node

出力例：

⚡️ Node runtimes in your toolchain:
    v20.11.1
    v22.16.0 (default)

(default) が付いているバージョンは現在使用中なので、削除しないように注意してください。

🧰 PowerShellで古いNodeを削除する安全スクリプト

下記スクリプトをPowerShellに貼り付けて実行するだけで、指定したNodeバージョンを安全に削除できます。


$target = "22.16.0"   # 先頭の v は付けない
$dir = Join-Path $env:LOCALAPPDATA "Volta\tools\image\node\$target"

# 念のため default かどうかチェック
$default = (volta list node | Select-String '\(default\)').ToString() -match 'v(\d+\.\d+\.\d+)' | Out-Null; $matches = $Matches
if ($matches) { $defaultVer = $matches[1] }

if ($defaultVer -eq $target) {
  Write-Host "このバージョンは default なので削除できません。別のバージョンを default に設定してください。"
} elseif (Test-Path $dir) {
  Write-Host "Removing $dir"
  Remove-Item -Recurse -Force $dir
  Write-Host "Done. 再確認 → volta list node"
} else {
  Write-Host "フォルダが見つかりません: $dir"
}

上記を実行すると、指定したフォルダ（例：22.16.0）が安全に削除されます。

⚡ defaultバージョンを変更したい場合

もし削除したいNodeが現在のdefaultに設定されている場合は、まず別のバージョンをdefaultに変更します。

volta install node@latest
volta set node@22.9.0

その後、古いバージョンを削除すればOKです。

🧹 まとめ

目的	コマンド / 手順
現在のNode一覧を確認	`volta list node`
defaultのNodeを変更	`volta set node@22.9.0`
Node実体フォルダの場所	`%LOCALAPPDATA%\Volta\tools\image\node\`
特定バージョンを削除	上記PowerShellスクリプトを実行

これで、Windows上のVolta環境でも不要なNode.jsバージョンを安全にクリーンアップできます。

💡 おまけ：バージョン管理のベストプラクティス

プロジェクトごとに volta pin node@xx を設定しておくと、意図しないバージョン変更を防げます。
定期的に volta list node を実行して、古いバージョンをチェックしましょう。
VoltaはRust製で非常に高速・安全なので、Node環境管理の標準ツールとしておすすめです。

この記事では、Windows + Volta環境で古いNode.jsバージョンを削除する手順を紹介しました。 Voltaは便利なツールですが、まだNodeアンインストール機能が実装されていないため、手動スクリプトによる削除が現時点で最も安全な方法です。