Linux で NVM を使用して Node.js バージョンを切り替える方法（ステップバイステップガイド）

複数の Node.js バージョンを管理することは、特に異なる Node.js 設定を必要とする複数のプロジェクトに取り組んでいる場合、煩雑になることがあります。Node Version Manager (NVM) を使用すると、Linux で Node.js バージョンを簡単かつクリーンに切り替えることができます。このガイドでは、NVM のインストール方法、Node バージョンの切り替え方法、デフォルト設定の方法、および一般的な問題の迅速な解決方法について詳しく説明します。

ステップ 1: Linux に NVM をインストールする

ターミナルで次のコマンドを実行します：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

このスクリプトは NVM を自動的にダウンロードしてインストールします。

インストールの確認

シェルをリロードします：

source ~/.bashrc  # Bash ユーザーの場合
source ~/.zshrc   # Zsh ユーザーの場合

次に NVM のインストールを確認します：

nvm --version

バージョン番号が表示されるはずです。

インストールのトラブルシューティング

nvm: command not found というエラーが発生した場合：

• ~/.bashrc または ~/.zshrc に以下の行があるか確認してください：

export NVM_DIR=""$HOME/.nvm""
[ -s ""$NVM_DIR/nvm.sh"" ] && . ""$NVM_DIR/nvm.sh""

• これらの行を追加した後、シェルを再度リロードしてください。

ステップ 2: Node.js バージョンのインストールと管理

最新の Node.js バージョンをインストールする

最新の Node.js をインストールします：

nvm install node  # 最新リリース
nvm install --lts # 最新の長期サポート（LTS）バージョン

特定の Node.js バージョンをインストールする

特定の Node.js バージョン（例：20.11.0）を見つけてインストールします：

nvm ls-remote
nvm install 20.11.0

インストール済みバージョンの一覧表示

インストール済みの Node バージョンを確認します：

nvm ls

ステップ 3: Node.js バージョンの切り替え

Node.js バージョンを瞬時に切り替えます：

nvm use 20.11.0

アクティブなバージョンを確認します：

node -v

デフォルトの Node.js バージョンを設定する

新しいターミナル用のデフォルト Node.js を設定します：

nvm alias default 20.11.0

ステップ 4: プロジェクト固有のバージョンに .nvmrc を使用する

プロジェクトフォルダに .nvmrc ファイルを作成し、内部に Node バージョン（例：20.11.0）を記述します。その後、次のコマンドを使用します：

nvm use

NVM は .nvmrc ファイルからバージョンを自動的に選択します。

一般的な問題とクイックソリューション

Node バージョンが変更されない

• 誤ってシステムにインストールされた Node.js を使用していないことを確認してください。
• which node を実行して、NVM で管理されている Node がアクティブであることを確認します。
• NVM コマンドや npm パッケージのインストールには 絶対に sudo を使用しないでください。

バージョン切り替え後にグローバル npm パッケージが見つからない

各 Node.js バージョンは独自のグローバル npm パッケージを管理します。グローバルパッケージを移行するには：

nvm install 20 --reinstall-packages-from=18

""18"" を移行元の Node バージョンに置き換えてください。

NVM の更新

NVM をシームレスに更新するには、インストールスクリプトを再度実行します：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

これにより、インストール済みの Node バージョンに影響を与えることなく NVM が更新されます。

結論

NVM を使用することで、複数の Node.js 環境の管理が大幅に簡素化されます。素早い切り替えが可能になり、バージョンの競合を避け、Linux での開発ワークフローをスムーズに保ちます。

よくある質問