Node.js バージョン管理｜nvm・fnm・mise・Volta比較と実測

Node.js のバージョン管理とは、1台のPCに複数の Node.js を入れておき、プロジェクトごとに使うバージョンを切り替えることです。 代表的なツールは nvm・fnm・mise・Volta の4つで、どれも「バージョンをインストールする」「ディレクトリに置いたファイルを読んで切り替える」という役割は同じです。違いは シェル起動の速さ、Windows 対応、読めるバージョンファイルの種類、そしてメンテナンス状況 に出ます。

この記事では4ツールを実際にインストールし、同じ Node.js 22 / 24 を入れて切り替え、シェル起動時間を hyperfine で実測しました。あわせて、Volta の README に掲載されたメンテナンス終了の告知、Node.js 25 以降で同梱されなくなった corepack の扱い、nvm から fnm / mise への移行コマンド、.node-version を置くだけで切り替わる設定例をコピペできる形でまとめます。

検証環境： Linux x64（2 vCPU）、bash 5.2.21、nvm 0.40.8、fnm 1.39.0、mise 2026.9.16、Volta 2.0.2、hyperfine 1.20.0。インストールした Node.js は 22.23.3 と 24.21.0 です（2026年9月時点で 24 が Active LTS、22 が Maintenance LTS、26 が Current で 2026-10-28 に LTS 入り予定。nodejs/Release の schedule.json で確認）。

Node.js バージョン管理ツールの早見表

迷ったら「Node だけなら fnm、ほかの言語もまとめるなら mise、既存の nvm 環境はそのまま使ってもよい」 が基本の選び方です。○×は各ツールの公式ドキュメントと、この記事の実行結果で確認したものです。

4ツールの特徴を1行ずつで理解する

Node.js 公式のダウンロードページ（nodejs.org/en/download）では、nvm・fnm・Docker が推奨として表示され、ほかに Homebrew・Chocolatey・n・asdf が選べます。これは nodejs.org のソース（apps/site/util/download/constants.json）で確認しました。なお同ページには「これらのインストールスクリプトは Node.js プロジェクトが管理しているものではない」旨の注記があります。

Volta のメンテナンス状況（公式 README の告知）

Volta の GitHub リポジトリ（volta-cli/volta）の README 冒頭には、次の告知が掲載されています（2025年11月の更新）。

Volta is unmaintained. Everything that works today should continue to do so for the foreseeable future, so if it is working for you, there is no particular urgency to migrate to another tool, but we will not be able to address breakages from new OS releases or other changes in the ecosystem, so you should put it on your maintenance roadmap at some point. We recommend migrating to mise.

要点は次の3つです。

• 今動いている環境は、当面そのまま動く（急いで移行する必要はない）
• 新しい OS やエコシステムの変化で動かなくなった場合の修正は行われない
• 移行先として mise を推奨（議論は issue #2080）

そのため 新しく選ぶなら fnm か mise、Volta を使っているチームは「保守計画に移行を入れておく」 のが公式の案内に沿った進め方です。移行手順は後半で紹介します。

実測：シェル起動時間とコマンド実行の上乗せ

バージョン管理ツールはシェル起動のたびに初期化処理を行うため、ターミナルを開く速さに影響します。bash -i -c exit（対話シェルを起動してすぐ終了）を各ツールの初期化つきで30回ずつ計測しました。

# 例：fnm の初期化だけを書いた rc ファイルで計測
hyperfine -N --warmup 3 --runs 30 \
  -n none "bash --noprofile --rcfile none.rc -i -c exit" \
  -n fnm  "bash --noprofile --rcfile fnm.rc  -i -c exit"

実行結果（hyperfine 1.20.0 の Markdown 出力をそのまま掲載）：

各 rc ファイルの中身は次のとおりです（公式の推奨設定）。

読み取れること：

• nvm の通常読み込みは約0.24秒。既定バージョンを使えるようにする処理（nvm use default 相当）に時間がかかっています。--no-use にすると約16msまで短くなりますが、その場合は シェルを開いた直後に nvm use が必要です。
• fnm は +3.7ms、Volta は PATH を足すだけなのでほぼゼロ。
• mise は +19ms。Node 以外のツールや環境変数も扱う分の処理ですが、体感で待つほどではありません。

一方 shim 方式は、node を実行するたびに判定処理が入ります。node -v を30回ずつ計測した結果です。

上乗せは1回あたり数ms〜10ms程度です。対話シェルでは mise activate（PATH 方式、shim を通らない）、IDE や CI のようにシェルフックが動かない場面では shim、と使い分けるのが mise の公式の案内です。

数値はこのコンテナでの結果で、マシンやシェル設定で変わります。大小関係（nvm 通常読み込み ≫ mise > fnm > Volta） を目安にしてください。

インストールと基本コマンドの対応表

実際に各ツールで Node.js 22 と 24 を入れた出力です。

$ nvm --version
0.40.8
$ nvm install 24
Computing checksum with sha256sum
Checksums matched!
Now using node v24.21.0 (npm v11.6.2)
$ nvm ls-remote --lts | tail -2
       v22.23.3   (Latest LTS: Jod)
       v24.21.0   (Latest LTS: Krypton)

$ fnm --version
fnm 1.39.0
$ fnm install --lts
Installing Node v24.21.0 (x64)
$ fnm ls
* v22.23.3 default
* v24.21.0 lts-latest
* system

$ mise use node@24
mise ✓ node@24.21.0  2.8s  node-v24.21.0-linux-x64.tar.gz
mise ████████████████ 1/1 · installed 1 tool in 2.8s
mise .../proj/m/mise.toml tools: node@24.21.0
$ cat mise.toml
[tools]
node = "24"

$ volta pin node@22   # 実行後の package.json を確認
$ grep -A3 '"volta"' package.json
  "volta": {
    "node": "22.23.3"
  }
}
$ node -v        # package.json があるディレクトリ
v22.23.3
$ cd .. && node -v   # 外に出ると既定の 24
v24.21.0

補足（検証方法）： このコンテナからは nodejs.org に直接接続できないため、npm レジストリで配布されている Node.js バイナリ（node-linux-x64 パッケージ）から nodejs.org/dist と同じ構成のファイルを作り、ローカルのミラーとして各ツールに指定しました。ミラーの指定方法は、社内プロキシ環境などでもそのまま使えます。

バージョンファイルの対応を実行して確かめる

「どのファイルを読むか」はツールごとにかなり違います。 チームで混在させるときに最もつまずく点なので、実際に試しました。

.node-version を読むか

.node-version に 22 を書いたディレクトリで node -v を実行した結果です（既定は 24）。

mise は .nvmrc / .node-version / devEngines を既定では読まないので、最初に次を実行します。

mise settings add idiomatic_version_file_enable_tools node

# ~/.config/mise/config.toml に次が追加される
[settings]
idiomatic_version_file_enable_tools = ["node"]

package.json の engines と devEngines

{ "name": "e2", "engines": { "node": ">=22 <23" } }

fnm は .node-version も .nvmrc もないとき engines.node の範囲から、入っている中で最新の一致バージョンを選びます（--resolve-engines は既定で有効）。

$ fnm use
Using Node v22.23.3

mise は公式ドキュメントで「engines.node は対応範囲の宣言であり、開発で使うバージョンではないので読まない」と明記しています。実行するとバージョン未設定の警告になります。

$ mise current node
mise WARN  Plugin node does not have a version set

devEngines は npm が定める「開発に使うランタイムやパッケージマネージャー」の宣言です。

{ "name": "e1", "devEngines": { "runtime": { "name": "node", "version": "22.23.3", "onFail": "error" } } }

$ mise current node      # idiomatic ファイル有効化済み
22.23.3
$ fnm use
error: Can't find version in dotfiles. Please provide a version manually to the command.

npm 自身も devEngines を確認します。 Node 24 で上の package.json に npm install すると、onFail: "error" なので止まります。

npm error code EBADDEVENGINES
npm error EBADDEVENGINES The developer of this package has specified the following through devEngines
npm error EBADDEVENGINES Invalid devEngines.runtime
npm error EBADDEVENGINES Invalid semver version "22.23.3" does not match "v24.21.0" for "runtime"

onFail を "warn" にすると npm warn EBADDEVENGINES ... の警告だけで続行します（npm 10.9.4 で確認）。バージョン管理ツールで切り替え、npm の devEngines で取り違えに気づく、という二段構えにできます。

チームで揃えるときのおすすめ

cd するだけで自動で切り替える設定（コピペ用）

.node-version を置いたディレクトリに入るだけで切り替わるようにする設定です。bash なら ~/.bashrc、zsh なら ~/.zshrc に書きます。

# fnm（親ディレクトリのファイルも探す recursive を指定）
eval "$(fnm env --use-on-cd --version-file-strategy=recursive --shell bash)"   # zsh は --shell zsh

# mise
eval "$(mise activate bash)"   # zsh は mise activate zsh
mise settings add idiomatic_version_file_enable_tools node   # 初回だけ実行

# Windows PowerShell（$PROFILE に追記）
fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression

nvm は 自動切替を標準では持たないので、README の cdnvm（bash）や load-nvmrc（zsh）を貼ります。短く書くと次のとおりです。

# ~/.bashrc（nvm.sh の読み込みより後）
cdnvm() {
  command cd "$@" || return $?
  if [ -n "$(nvm_find_nvmrc)" ]; then
    nvm use --silent >/dev/null 2>&1 || nvm install
  else
    nvm use --silent default >/dev/null
  fi
}
alias cd='cdnvm'

3つの設定を対話シェルで動かした結果の抜粋です（p22 に 22、p24 に 24 を置き、既定は 22）。

######## fnm
$ cd .../proj/p22
$ node -v
v22.23.3
$ cd .../proj/p24
Using Node v24.21.0
$ node -v
v24.21.0
######## mise
$ cd .../proj/p24
$ node -v
v24.21.0
######## nvm（上の cdnvm）
$ cd .../proj/p24
$ node -v
v24.21.0

mise でどのプロジェクトにも当てはまらない場所では、mise use -g で決めた既定バージョン（未設定ならシステムの node） が使われます。

状況別の選び方

flowchart TD
    A[Node.js のバージョンを切り替えたい] --> B{Node 以外の言語も<br>同じ方法で管理したい？}
    B -- はい --> M[mise]
    B -- いいえ --> C{Windows ネイティブでも使う？}
    C -- はい --> F[fnm]
    C -- いいえ --> D{nvm を使っていて<br>今のままで満足？}
    D -- はい --> N[nvm を継続<br>起動が遅ければ --no-use か fnm へ]
    D -- いいえ --> F
    V[Volta を使っている] --> W[当面は継続可<br>計画的に mise へ]

nvm から fnm / mise へ移行するコマンド

nvm → fnm

# 1. fnm を入れる
curl -o- https://fnm.vercel.app/install | bash

# 2. nvm で入れていたバージョンを fnm にも入れる
for v in $(ls "$NVM_DIR/versions/node"); do fnm install "${v#v}"; done
fnm default 24

# 3. ~/.bashrc の nvm 読み込み（NVM_DIR と nvm.sh の2〜3行）を消し、fnm の行に置き換える
eval "$(fnm env --use-on-cd --version-file-strategy=recursive --shell bash)"

プロジェクトの .nvmrc はそのままで大丈夫です。fnm は .nvmrc を読みます。グローバルに入れた npm パッケージ（npm i -g したもの）は移らないので、npm ls -g --depth=0 で確認して入れ直します。

nvm → mise

mise には nvm で入れた Node.js をシンボリックリンクで取り込む mise sync node --nvm があります。

$ mise sync node --nvm
Synced node@22.23.3 from nvm
Synced node@24.21.0 from nvm
$ mise ls node
node  22.23.3 (symlink)
node  24.21.0 (symlink)

# .nvmrc を読むようにする
mise settings add idiomatic_version_file_enable_tools node
# 既定のバージョン
mise use -g node@24
# ~/.bashrc の nvm 読み込みを消して、次に置き換える
eval "$(mise activate bash)"

リンクは nvm のディレクトリを指しているので、nvm のディレクトリを消す前に mise install node@22 などで mise 側に入れ直すと安心です。

Volta → mise

mise は package.json の volta フィールドを読みません（実行して確認）。そこで volta に書かれたバージョンを .node-version か mise.toml に書き写します。

# package.json の volta.node を .node-version に書き出す（Node.js で実行）
node -p "require('./package.json').volta.node" > .node-version
cat .node-version   # 22.23.3

CI の actions/setup-node は package.json を指定すると volta.node → devEngines.runtime → engines.node の順に読むので、移行中は volta フィールドを残しておいても CI は動きます。

corepack と pnpm / yarn のバージョン

corepack は Node.js 本体ではなく、pnpm や yarn のバージョンを package.json の packageManager で固定する仕組みです。

• Node.js 25 以降は corepack が同梱されません（Node.js 25 の変更履歴に「build: stop distributing Corepack」）。
• 使う場合は npm install -g corepack で入れます（nodejs.org のダウンロードページの手順と同じ）。npm での最新版は 0.36.0 でした。
• Node.js 24 以前は同梱されていますが、有効化には corepack enable が必要です。

{
  "packageManager": "pnpm@12.6.0"
}

役割分担は 「Node.js 本体のバージョン → fnm / mise / nvm」「pnpm・yarn のバージョン → corepack か mise」 と考えると整理できます。mise は mise use pnpm@12 のように pnpm も管理でき、fnm は --corepack-enabled で Node を入れるたびに corepack enable を実行できます。

CI（GitHub Actions）でローカルと同じバージョンを使う

ローカルのバージョンファイルを CI でも読むと、手元と CI のずれがなくなります。

# .github/workflows/test.yml
name: test
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-node@v7
        with:
          node-version-file: '.node-version'   # .nvmrc / mise.toml / package.json も可
      - run: npm ci
      - run: npm test

setup-node の公式ドキュメントでは、node-version-file に .nvmrc、.node-version、.tool-versions、mise.toml、package.json を指定できると説明されています。mise で全ツールを管理しているなら、公式の jdx/mise-action を使う方法もあります（この YAML は CI 上では未実行です）。

よくあるつまずきと対処

よくある質問

Q. nvm・fnm・mise を同時に入れても大丈夫ですか？ A. 入れること自体はできますが、シェルの初期化で PATH を書き換える順番によって、どの node が使われるかが変わります。移行中を除き、シェルの初期化に書くのは1つにして、which node で確認するのがおすすめです。

Q. .nvmrc と .node-version はどちらを置けばよいですか？ A. チームに nvm ユーザーがいるなら .nvmrc、いなければ .node-version が扱いやすいです。どちらも中身は 24 や 24.21.0 のようなバージョン1行で、fnm と mise（有効化後）はどちらも読みます。

Q. Volta はもう使わないほうがよいですか？ A. 公式 README の告知どおり、今動いている環境は当面そのまま使えます。新しい OS への対応などは行われないため、次の環境更新のタイミングで mise への移行を計画に入れておくのが安心です。

Q. バージョン指定は 22 と 22.23.3 のどちらがよいですか？ A. 再現性を重視するならパッチまで固定（22.23.3）、セキュリティ更新を自動で取り込みたいならメジャーのみ（22） です。CI とローカルで同じファイルを読ませれば、どちらでもずれは起きません。

まとめ

• 4ツールの役割は同じ。違いは 起動速度・Windows 対応・読めるファイル・メンテナンス状況
• 実測では nvm の通常読み込みが約0.24秒、fnm は +3.7ms、mise は +19ms、Volta はほぼゼロ
• Node だけなら fnm、複数言語なら mise。nvm は --no-use で起動を速くできる
• Volta は公式 README でメンテナンス終了を告知。当面は動作し、移行先として mise を推奨
• mise の .nvmrc / .node-version 対応は設定で有効化、fnm は engines.node も読む
• Node.js 25 以降は corepack が別途インストール（npm install -g corepack）
• CI は setup-node の node-version-file でローカルと同じファイルを読む

株式会社RJCでは、チーム全員が同じ Node.js で開発を始められるように、開発環境の揃え方をプロジェクトの中で仲間と学び合っています。こうした知識を共有しながら、日々技術を磨いています。

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。