Node.jsのバージョン管理ツールとして人気のある「fnm（Fast Node Manager）」から「Volta」への乗り換えを検討している方に向けて、両者の違いと移行手順、そしてVoltaを選ぶべきケースについて解説します。

fnmとVoltaの比較

Voltaを選ぶべきケース

以下のようなケースでは、Voltaへの乗り換えが強く推奨されます。

• CI環境でpre-commitやlint-stagedなどを実行している
• Node.jsやnpmのバージョンをpackage.jsonで明示している
• チーム開発でツールのバージョン差異によるトラブルを防ぎたい
• グローバルにインストールしたツールをプロジェクトごとに固定したい

Voltaのインストール方法

Voltaの導入は非常にシンプルです。公式サイト にもありますが、以下のようなコマンドを実行してください。

Windows

winget install Volta.Volta

Mac等Unix系

curl https://get.volta.sh | bash

fnmからVoltaへ乗り換える手順

1. fnmでインストール済みのNodeバージョンを確認する
2. Voltaをインストールする
3. 使用中のNodeバージョンをVoltaでもインストール・固定化

例: Node.js 20をVoltaで設定する

volta install node@20

現在のプロジェクトで使用する Node.js のバージョンを固定するには以下のようなコマンドを実行します。

volta pin node@20

これで、package.jsonに以下のような記述が追加されます。

{
  "volta": {
    "node": "20.11.0"
  }
}

又、以下のような記述を追加すれば、CIや他のツールでもバージョンが一致します。

{
  "engines": {
    "node": ">=20"
  }
}

CI環境での設定例（GitHub Actions）

GitHub ActionsでVoltaを使うには、次のような設定が簡単です。

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Volta
        uses: volta-cli/action@v4
      - run: npm ci
      - run: npx pre-commit run --all-files

まとめ

fnmは非常に高速で優れたツールですが、プロジェクトごとにNode.jsやnpmのバージョンを固定したい場合や、CI・チーム開発での再現性を重視するなら、Voltaの方が一歩リードしています。

これから新しくプロジェクトを始める、あるいはCIやpre-commitで安定性を求める方は、Voltaへの移行を検討してみてください。