Node.jsバージョン管理｜nvm・fnm比較とVolta移行時の注意

Node.jsバージョン管理ツールの選定基準

Node.jsをプロジェクトごとに切り替えるなら、Linux・macOS・WSLではnvm、Windowsを含む複数OSではfnmが候補です。2026年10月6日の確認では、Voltaは公式にメンテナンス終了を明示しており、新規導入の推奨から外します。編集部では、チームが使うOSとバージョン指定ファイルに合わせて一つの管理ツールを選ぶことを勧めます。

OSと用途による比較

以下の表は、主要なバージョン管理ツールの特徴をまとめたものです。

各ツールの詳細と特徴

nvm (nvm-sh) と nvm-windows

nvmには、開発者が混同しやすい2つの異なる実装が存在します。

nvm (nvm-sh) は、POSIX準拠のシェル（bash, zshなど）を対象としたツールです。Linux、macOS、およびWindows上のWSL（Windows Subsystem for Linux）環境での利用を前提としています。

一方、nvm-windowsの公式リポジトリはWindowsネイティブ環境向けの別プロジェクトです。WindowsのコマンドプロンプトやPowerShellで動作させる場合は、fnmやnvm-windowsなど、Windowsネイティブに対応するツールを選びます。

fnm

fnmはRust言語で実装されたバージョン管理ツールです。Windows、macOS、Linuxのいずれでも動作するクロスプラットフォーム対応のツールです。

fnmを最大限に活用するには、以下の設定が必要です。

• シェル初期化の設定: シェル起動時にfnmを読み込む設定が必要です。
• 自動切り替え: .node-version または .nvmrc ファイルを検知して自動的にバージョンを切り替えるには、シェル設定に --use-on-cd オプションを含める必要があります。

Voltaの現状と移行

2026年10月6日時点のVolta公式READMEによれば、Voltaは「unmaintained（メンテナンスされていない）」状態にあります。Volta公式リポジトリは mise への移行を推奨しています。

Voltaを使用している環境において、動作中のシステムに対して直ちに緊急の移行を求めるものではありませんが、新規のプロジェクトにVoltaを採用することは推奨されません。

Node.jsバージョンの決定プロセス

Node.jsのバージョンを選択する際は、単に「最新版」を選ぶのではなく、プロジェクトの安定性とサポート期間を考慮する必要があります。

公式リリース情報の確認

特定のバージョンを決定する前に、必ずNode.js公式のリリース情報を確認してください。

バージョン選定のポイントは以下の通りです。

1. LTS（Long Term Support）の選択: 長期的な安定性が必要なプロジェクトでは、LTS版を選択します。
2. サポート期間の確認: 選択したバージョンがいつまでセキュリティアップデートを受けられるかを確認します。
3. 依存関係の検証: プロジェクトで使用する他のライブラリが、そのNode.jsバージョンをサポートしているかを確認します。

プロジェクトでのバージョン固定

チーム開発においては、メンバー全員が同じ環境で動作を確認できるよう、具体的なバージョンをファイルに記録して共有します。

• 使用するファイル: .nvmrc または .node-version をプロジェクトのルートディレクトリに配置します。
• 記載内容: 「Node 22」のような大まかな指定ではなく、公式のリリース表に基づいた具体的なバージョンを記載してください。

実装と移行の手順

実行前の環境診断

新しいバージョン管理ツールを導入したり、バージョンを切り替えたりする前には、現在の環境にパスの競合がないかを確認してください。

以下のコマンドを使用して、現在どのパスにあるNode.jsが実行されているかを確認できます。

• POSIX系 (Linux/macOS/WSL): command -v node
• Windows (PowerShell): Get-Command node

また、Node.jsおよびnpmのバージョンについても、以下のコマンドで現在の状態を把握しておきます。 node --version npm --version

インストールと初期設定

各ツールのインストール手順については、各プロジェクトの要件に合わせ、必ず公式のドキュメントを参照してください。

• nvm-sh 公式リポジトリ
• fnm 公式リポジトリ
• Volta 公式リポジトリ

ダウンロードしたスクリプトの内容や取得先を確認してから実行してください。管理ツールを複数同時に初期化するとPATHが競合するため、使うものを一つに絞ります。

Voltaから他ツールへの移行

Voltaから他のツール（miseなど）へ移行する場合、以下の手順で確認を行います。

1. 既存のPinの確認: package.json 内に記述されているVoltaのバージョン固定設定（pin）を確認します。
2. 移行後の検証: 新しいツールでバージョンを切り替えた後、プロジェクトが正常に動作するか確認します。
3. グローバルパッケージの注意点: npm global でインストールしたパッケージは、Node.jsのバージョンを切り替えると、そのバージョンごとに独立して管理されます。バージョンを切り替えると、以前のバージョンでインストールしたグローバルパッケージが見えなくなるため、必要に応じて再インストールが必要です。

バージョンファイルを使って切り替える

nvmでは.nvmrcを読み込む

プロジェクトが指定するバージョンを.nvmrcへ記録したうえで、プロジェクト内で次の順に確認します。リリース表と依存関係に合うバージョンを使ってください。

nvm install
nvm use
node --version
npm --version
command -v node

出典：nvm公式ガイド。nvm useが成功しても、エディタ内のターミナルや別シェルが同じ環境とは限りません。それぞれの起動環境で確認します。

fnmではシェルごとの初期化を行う

出典：fnm公式ガイド。bash、zsh、PowerShellでは初期化の書き方が違います。使うシェルの案内に従ってfnm envと--use-on-cdを設定し、新しいシェルを開いて、バージョン指定ファイルのあるディレクトリで確認します。

編集部では、移行後に依存関係のインストールだけでなく、普段の起動・ビルド・テストを実際に実行してから旧管理ツールの設定を外すことを勧めます。移行前の指定バージョンと初期化設定を残しておけば、問題時に戻せます。

CI/CDにおけるベストプラクティス

継続的インテグレーション（CI）環境では、ローカル開発環境と完全に一致したNode.jsバージョンを使用することが重要です。

• バージョンの同期: ローカルで使用しているバージョンと、CIパイプラインで使用するバージョンを一致させてください。
• ロックファイルの維持: package-lock.json や yarn.lock などのロックファイルを必ずリポジトリに含め、CI環境でもこれを使用してインストールを行ってください。
• クリーンな環境: 切り替え時に git clean を実行する必要はありませんが、環境の整合性を保つために、CI環境では常にクリーンな状態からプロセスを開始することが推奨されます。

詳細なスクリプト作成や自動化については、PowerShellのワークフロー作成や、Linuxサーバーのセキュリティ強化のガイドラインを参考にしてください。

よくある失敗とトラブルシューティング

パスの競合による誤動作

複数のツール（例：nvmとfnm）を同時にインストールしている場合、command -v node で表示されるパスが意図しないツールを指していることがあります。これは、シェルの PATH 環境変数の優先順位が原因です。使用するツールの設定が、シェルの初期化ファイル（.bashrc, .zshrc など）の適切な位置に記述されているか確認してください。

グローバルパッケージの消失

以前のNode.jsで導入したグローバルCLIが見つからない場合は、管理ツールのパッケージ管理方式を確認します。npm自体が見つからない場合は、Node.jsの導入状態やPATHを調べてください。どちらも単に「仕様」として放置せず、実行ファイルの場所とバージョンを確認します。

FAQ

Q1: nvm-shとnvm-windowsは同じものですか？

いいえ、全く別のツールです。nvm-shはLinux/macOS/WSL向けであり、nvm-windowsはWindowsネイティブ環境向けです。

Q2: fnmで自動的にバージョンを切り替えるにはどうすればよいですか？

シェルの設定ファイルにfnmの初期化設定を追加し、--use-on-cd オプションを有効にしてください。これにより、.node-version や .nvmrc があるディレクトリに移動した際に自動で切り替わります。

Q3: Voltaを使用している場合、すぐに他のツールへ移行すべきですか？

公式が「unmaintained」と明示しているため、新規プロジェクトではVoltaではなく、miseなどのメンテナンスされているツールを選択することが推奨されます。既存の動作中の環境については、計画的に移行を検討してください。

Q4: Node.jsのバージョンは常に最新版（Current）を選ぶべきですか？

いいえ。プロジェクトの安定性を重視する場合は、公式のリリース表を確認し、LTS（Long Term Support）版を選択してください。

Q5: 切り替え後に以前のグローバルCLIが見つかりません。

管理ツールがグローバルパッケージをどう扱うかを確認し、必要なCLIを移行先に導入します。npm自体が見つからない場合は、Node.jsの導入状態とPATHを先に調べます。