Skip to content

Volta のアンインストール

Voltaを完全にシステムから削除したい場合、以下の手順に従ってください。

アンインストール手順

Unix系システム(macOS、Linux)

1. Voltaディレクトリの削除

bash
rm -rf ~/.volta

2. シェル設定からVoltaの設定を削除

使用しているシェルに応じて、以下のファイルからVolta関連の行を削除してください:

  • Bash: ~/.bashrc~/.bash_profile~/.profile
  • Zsh: ~/.zshrc
  • Fish: ~/.config/fish/config.fish

削除する行:

bash
export VOLTA_HOME="$HOME/.volta"
export PATH="$VOLTA_HOME/bin:$PATH"

Windows

方法1:プログラムと機能から削除(推奨)

  1. 設定 > アプリ > アプリと機能を開く
  2. "Volta"を検索
  3. アンインストールをクリック

方法2:PowerShellでの手動削除

powershell
# Voltaディレクトリを削除
Remove-Item -Recurse -Force $env:LOCALAPPDATA\Volta

# 環境変数を削除(要管理者権限)
[Environment]::SetEnvironmentVariable("VOLTA_HOME", $null, "User")
$path = [Environment]::GetEnvironmentVariable("PATH", "User")
$newPath = $path -replace ";$env:LOCALAPPDATA\\Volta\\bin", ""
[Environment]::SetEnvironmentVariable("PATH", $newPath, "User")

インストールされたツールの確認

アンインストール前に、Voltaでインストールしたツールを確認できます:

bash
volta list all

手動クリーンアップ

残存ファイルの検索

bash
# Unix系
find ~ -name "*volta*" -type f 2>/dev/null

# すべてのシンボリックリンクを確認
find ~/.volta -type l 2>/dev/null
powershell
# Windows
Get-ChildItem -Path $env:USERPROFILE -Recurse -Name "*volta*" -ErrorAction SilentlyContinue

シェル設定の確認

bash
# Volta設定が残っていないか確認
grep -r "volta" ~/.bashrc ~/.zshrc ~/.profile 2>/dev/null

既存のNode.js/npmへの復帰

Voltaをアンインストールした後、システムにインストールされたNode.jsがある場合:

Node.jsの確認

bash
# システムのNode.jsバージョンを確認
node --version
npm --version

# Node.jsの場所を確認
which node
which npm

パッケージマネージャーでのNode.js管理

macOS(Homebrew)

bash
# HomebrewでNode.jsをインストール
brew install node

# バージョンの確認
node --version

Windows(Chocolatey)

powershell
# ChocolateyでNode.jsをインストール
choco install nodejs

# バージョンの確認
node --version

Ubuntu/Debian

bash
# NodeSourceリポジトリからインストール
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# バージョンの確認
node --version

グローバルパッケージの再インストール

Voltaで管理していたグローバルパッケージを手動で再インストールする必要があります:

bash
# よく使用されるグローバルパッケージの例
npm install -g \
  eslint \
  prettier \
  typescript \
  nodemon \
  @vue/cli \
  create-react-app

代替のNode.jsバージョン管理

Voltaをアンインストールした後、他のツールでNode.jsバージョンを管理できます:

nvm(Node Version Manager)

bash
# nvmのインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Node.jsのインストール
nvm install node
nvm use node

n(Nodeバージョン管理)

bash
# nのインストール
npm install -g n

# 最新のLTSバージョンをインストール
n lts

fnm(Fast Node Manager)

bash
# fnmのインストール
curl -fsSL https://fnm.vercel.app/install | bash

# Node.jsのインストール
fnm install --lts
fnm use lts

トラブルシューティング

アンインストール後にVoltaコマンドが残る

bash
# PATHを確認
echo $PATH

# シェル設定を再読み込み
source ~/.bashrc  # または適切な設定ファイル

# 新しいターミナルセッションを開始
exec $SHELL

権限エラー

bash
# ファイルの所有者を確認
ls -la ~/.volta

# 権限が不足している場合
sudo rm -rf ~/.volta

Windows環境変数の問題

PowerShellで管理者権限で実行:

powershell
# システム環境変数からVoltaを削除
[Environment]::SetEnvironmentVariable("VOLTA_HOME", $null, "Machine")
$systemPath = [Environment]::GetEnvironmentVariable("PATH", "Machine")
$newSystemPath = $systemPath -replace ";C:\\Program Files\\Volta\\bin", ""
[Environment]::SetEnvironmentVariable("PATH", $newSystemPath, "Machine")

完全削除の確認

bash
# Voltaコマンドが利用できないことを確認
volta --version
# エラー: command not found

# システムのNode.jsが正常に動作することを確認
node --version
npm --version

# パッケージマネージャーでの管理が正常であることを確認
npm list -g --depth=0

これでVoltaが完全にシステムから削除されました。必要に応じて、他のNode.jsバージョン管理ツールに移行できます。