WindowsにNodeのバージョン管理を導入する

1. はじめに

Node.jsは、JavaScriptをサーバーサイドでも使用するための環境ですが、バージョン管理が難しいこともあります。
特に複数のプロジェクトを並行して開発している場合、異なるNode.jsのバージョンを使い分ける必要が出てきます。
そこで登場するのが、Node.jsのバージョン管理ツール「nvm（Node Version Manager）」です。

この記事では、Windows環境でnvm-windowsをインストールし、Node.jsのバージョン管理を簡単にする方法を紹介します。これを導入すれば、Node.jsのバージョンをプロジェクトごとに切り替えることが簡単にできるようになります！

2. Node.jsのバージョン管理とは？

Node.jsを使った開発では、バージョン管理が非常に重要です。
あるプロジェクトでは「Node.js v20」が必要で、別のプロジェクトでは「Node.js v22」が必要な場合、簡単にバージョンを切り替えられるツールが必須となります。
そこで、登場するのが「nvm（Node Version Manager）」というツールです。

nvmは、複数のNode.jsのバージョンを管理し、プロジェクトごとに適切なバージョンを切り替えることができます。
ですが、Windows環境では、nvmの公式ツールが動作しないため、nvm-windowsというWindows専用のツールを使います。

3. Windowsにnvmをインストールする方法

それでは、nvm-windowsを実際にインストールしていきましょう。

3-1.既存Nodeのアンインストール

初期インストールの場合は飛ばして問題ありません。
nvmで管理するため既存のNodeはアンインストールしておきます。

1. コントロールパネルを開く

• 「スタートメニュー」 → 「設定」 → 「アプリ」→ 「アプリと機能」を開きます。

2. Node.jsを探す

インストールされているアプリケーションの一覧から Node.js を探します。

3. アンインストール

Node.jsを選択し、「アンインストール」ボタンをクリックして、アンインストールを進めます。

3-2. nvm-windowsのダウンロード

まず、以下のリンクからnvm-windowsをダウンロードします。

nvm-windows GitHubリリースページ
nvm-setup.zipというファイルをダウンロードし、解凍します。

(2025/04/28現在はV1.2.2)

3-3. インストール設定

ダウンロードしたnvm-setup.exeを実行し、指示に従ってインストールします。
インストール先は、デフォルトのC:\Program Files\nvmで問題ありません。
Node.jsのインストール先も指定します（例えば、C:\Program Files\nodejs）。

自分は基本デフォルトのままひたすらNext

すでにNode.jsがインストールされている場合は使用中のバージョンをNVMで管理するか聞かれます。
使用中のものなので基本「はい」で問題ないと思います。

3-4. インストール後の確認

インストールが完了したら、コマンドプロンプトやPowerShellを開き、以下のコマンドを実行して、nvmのバージョンを確認しましょう。

4. nvmを使ってNode.jsのバージョンを管理する

これでnvmが使えるようになりました！
次に、実際にNode.jsのバージョンを管理していきます。

Node.jsをインストールする

指定したバージョンのNode.jsをインストールするには、以下のコマンドを使用します。

インストール可能なリストを表示するには

インストールしたNode.jsを確認したい場合は以下コマンドを実施

使用したバージョンがある場合は

設定できているか確認

5. よくあるトラブルとその対処法

• エラー: Node.jsのバージョン切り替え後に問題が発生
  → ターミナルを再起動することで解決できます。
• エラー: インストール先ディレクトリにアクセスできない
  → 管理者権限でインストールを実行し、インストール先ディレクトリを変更してみてください。

6. まとめ

これで、Windows環境でもNode.jsのバージョン管理が簡単にできるようになりました！
複数のプロジェクトを管理している場合に、このツールは非常に便利です。
Node.jsのバージョンを切り替える手間を省き、効率的な開発環境を作りましょう！