Node.jsバージョン管理を簡単に！nvm-windows導入ガイド
更新日：2024年12月20日

Node.jsを使った開発では、プロジェクトによって異なるNode.jsのバージョンが必要になることがよくあります。しかし、手動でバージョンを切り替えるのは面倒です。ここで役立つのが、Node.jsのバージョン管理を簡単に行えるツール「nvm-windows」です。本記事では、nvm-windowsの導入方法から使い方までを丁寧に解説し、開発効率を大幅に向上させる方法をご紹介します。

nvm-windowsとは？

nvm-windowsは、Node.jsのバージョン管理ツール「nvm（Node Version Manager）」のWindows向けバージョンです。nvm-windowsを使うことで、複数のNode.jsバージョンをインストールし、コマンド1つで簡単に切り替えることができます。

主な特徴

• 複数のNode.jsバージョンを同時に管理
• バージョンのインストールと削除が簡単
• プロジェクトごとに最適なバージョンを即座に切り替え可能

nvm-windowsのインストール手順

公式サイトからインストーラーをダウンロード

• nvm-windowsの公式GitHubリポジトリ（https://github.com/coreybutler/nvm-windows/releases）にアクセスします。
• 最新のリリースページから「nvm-setup.zip」をダウンロードします。

インストール

• ダウンロードした「nvm-setup.zip」を解凍し、インストーラーを実行します。
• インストールウィザードの指示に従い、nvm-windowsをインストールします。

環境変数の確認

• インストールが完了したら、コマンドプロンプトやPowerShellを開き、以下のコマンドを入力してnvmが正常にインストールされているか確認します。

nvm --version

• バージョンが表示されれば成功です。

Node.jsのインストールとバージョン管理

Node.jsのインストール

• 任意のバージョンをインストールするには、以下のコマンドを使用します。

nvm install <バージョン番号>

• 例: Node.js 16.17.0をインストールする場合

nvm install 16.17.0

インストール済みのバージョンを確認

nvm list

使用するバージョンを切り替える

• プロジェクトに応じて使用するNode.jsのバージョンを変更するには、以下のコマンドを実行します。

nvm use <バージョン番号>

デフォルトバージョンの設定

• 常に特定のバージョンを使用したい場合は、以下のコマンドで設定します。

nvm alias default <バージョン番号>

注意点とトラブルシューティング

nvm-windowsは既存のNode.jsと競合する可能性がある

• 既にNode.jsをインストールしている場合は、事前にアンインストールすることをおすすめします。

npmのグローバルパッケージが切り替え後に使えない場合

• 切り替えたNode.jsバージョンに応じて、必要なnpmパッケージを再インストールする必要があります。

環境変数の設定に問題がある場合

• 環境変数「NVM_HOME」と「NVM_SYMLINK」を確認し、適切なパスが設定されているかを確認してください。

まとめ

nvm-windowsを利用することで、Node.jsのバージョン管理が格段に楽になります。特に、複数のプロジェクトを同時に進行している場合や、特定のバージョンでのみ動作するライブラリを使用している場合には必須のツールです。この記事を参考に、ぜひnvm-windowsを導入して開発環境を最適化してください！