Node.jsのバージョン管理ツール「Volta」のインストール・導入方法・使い方を解説

近年のWeb制作ではコーディングをする際に「npm scripts」や「gulp」などのタスクランナー、「Webpack」などのバンドルツールを使うことが一般的になっています。

これらのツールを使用する際には、Node.jsが必要です。
しかし、プロジェクトごとに異なるNode.jsのバージョンが必要な場合があり、そのたびにNode.jsのバージョンを切り替える必要があります。

毎回Node.jsをアンインストールしてから特定のバージョンを再インストールすることも可能ですが、この作業は効率が悪いです。
そのため、Node.jsのバージョン管理ツールを使用することをお勧めします。

今回は、最近注目されているNode.jsのバージョン管理ツール「Volta」を導入してみましたので、インストールから使い方までを紹介していきます。

⚡️Voltaとは

VoltaはJavaScriptのツールマネージャーで、Node.jsのバージョン管理が主な役割です。
またNode.jsだけではなく、npm・yarnのバージョン管理も行うことが出来ます。

公式サイトのトップページの説明では「The Hassle-Free JavaScript Tool Manager（手間のかからない JavaScript ツールマネージャー）」というキャッチコピーで紹介されており、実際に私も導入してみてとても簡単に使用することができました。

さらに公式サイトではVoltaの特徴として以下の3つを挙げています。
※以下の日本語訳はGoogle翻訳を利用しています。

Voltaの特徴１「Fast（速い）」

Install and run any JS tool quickly and seamlessly! Volta is built in Rust and ships as a snappy static binary.

（翻訳：JS ツールをすばやくシームレスにインストールして実行します。Volta は Rust で構築されており、きびきびした静的バイナリとして出荷されます。）
VOLTA

まずはとにかく動作が早いということです。
実際に利用してみたところ処理速度については遅いと感じたことはなく、とても快適な使い心地でした。

Voltaの特徴２「Reliable（信頼できる）」

Ensure everyone in your project has the same tools—without interfering with their workflow.

（翻訳：ワークフローを妨げることなく、プロジェクトの全員が同じツールを使用できるようにします。）
VOLTA

Voltaを利用することでプロジェクトに参加しているメンバーの「Node.js」や「npm」のバージョンを自動で固定することができます。
この部分については後ほど実際にサンプルを作りながら使い方について説明します。

Voltaの特徴３「Universal（ユニバーサル）」

No matter the package manager, Node runtime, or OS, one command is all you need: volta install.

（翻訳：パッケージマネージャー、ノードランタイム、または OS に関係なく、必要なのは 1 つのコマンドだけですvolta install。）
VOLTA

WindowsやMacなどの異なるOSでも動作できます。
Voltaの特徴2のプロジェクトでバージョンを固定する機能も、全てのメンバーがVoltaを利用している必要がある為、OSを気にする必要なく安心してVoltaを導入できますね。

それではVoltaをインストールしてみましょう。

Node.jsをアンインストール

Voltaを導入する前に、すでにNode.jsとそのバージョン管理ツールをインストールしている場合は、それらをアンインストールしてから利用することが望ましいです。
Node.jsを公式サイトからインストールした場合も同様に、Node.js本体をアンインストールしてください。

Node.jsのバージョン管理ツールには「nodebrew」「nvm」「nodist」などがありますが、種類が多いため、ここではアンインストール方法の説明は省略します。
自分が使用しているバージョン管理ツールを特定し、「nodebrew アンインストール」などで調べてからアンインストールを行ってください。

私は下記の記事を参考にさせていただきました。

インストールしてあるNode.jsやnpmをアンインストール

Voltaをインストール

Macを利用している場合はVoltaのインストール方法は下記のコマンドを打ち込むだけで完了します。
Windowsの方は別途インストーラーが用意されているので、指示に従ってインストールを行なってください。

Volta本体をインストール

Macでのインストール方法

Macの場合は以下の 1 つのコマンドでVoltaをインストールできます。

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

Windowsでのインストール方法

Windowsの場合は、以下の公式ページのWindows Installationの指示に従ってインストールを行なってください。

Getting Started

Voltaがインストールされているか確認

Voltaがインストールされるとvoltaコマンドが利用できるようになりますので、試しに以下のコマンドでVoltaのバージョンを確認してみましょう。

volta -v

以下のようにバージョンが確認できたらVoltaのインストールは完了です。

1.1.0

Node.jsをインストール

Node.jsのインストールには「最新のLTS（安定版）」、「バージョンを指定」、「最新バージョン」の3つの方法があります。
また、npmもNode.jsと同時インストールされるので一緒に確認してみましょう。

バージョンを指定してインストール

バージョンを指定する際は、nodeの後に@をつけてバージョンの番号を指定します。
すでにバージョンの指定があるプロジェクトに新しく参加する場合などに、この方法を使用します。

指定したバージョンのLTS（安定版）をインストール

volta install node@14

指定したバージョンをインストール

volta install node@14.15.5

インストールの確認

インストールが完了したら、実際にNode.jsをインストールできているか確認しましょう。
下記のコマンドでVolta経由でインストールされているツールを全て確認できます。

volta list all

以下は上記のコマンドを実行した際の実行結果です。（実行結果の内容はそれぞれの環境によって異なります）
Node runtimes:の下に記載されているバージョンがインストールされているNode.jsのバージョンです。
バージョンの横に(default)と記載されているものが、現在利用しているNode.jsのバージョンになります。

# `volta list all`の実行結果
User toolchain:

    Node runtimes:
        v14.15.5
        v17.9.1
        v18.12.1
        v19.3.0 (default)

    Package managers:

    Packages:

バージョンの変更方法

Node.jsのバージョンの変更も先ほどのインストール方法と同じコマンドで変更できます。
以下のようにnode@の後に任意のバージョンを選択してインストールコマンドを実行します。

volta install node@バージョンの番号

npmの確認

最後にNode.jsのインストールを完了すると自動でnpmもインストールされているので、以下のバージョン確認のコマンドでnpmがインストールされているか確認しましょう。

npm -v

以下のようにバージョン番号が表示されたら成功です。

10.5.0

プロジェクトでバージョンを固定する

Voltaのvolta pinというコマンドを実行することで、プロジェクトのNode.jsのバージョンを揃えることができます。
volta pinを実行する際はpackage.jsonファイルがあることが前提になりますので、実際に作成して確認してみましょう。

volta pin

プロジェクトを作成

それではテスト用のプロジェクトディレクトリを作成し、そのディレクトリの内でpackage.jsonファイルを作成します。
以下のコマンドでpackage.jsonファイルを作成しましょう。

npm init -y

package.json

package.jsonファイルは、Node.jsプロジェクトの設定ファイルで、プロジェクトの依存関係やスクリプトなどを定義します。
このファイルには、プロジェクトの名前やバージョン、使用しているパッケージの情報なども含まれます。npm（Node.jsのパッケージマネージャ）がこれを読み込んで、プロジェクトの管理や依存関係の解決を行います。

「volta pin」コマンドでバージョンを固定

package.jsonファイルが作成できたら、以下のようにvolta pinの後にnode@バージョンの番号で、Node.jsのバージョンを固定します。

volta pin node@14

実行したら、package.jsonに以下のように記述が自動的に書き込まれます。

{
  ...
  "volta": {
    "node": "14.21.2"
  }
}

バージョンが書き込まれていたらバージョンの固定は完了です。
それでは擬似的に他のディレクトリを作成して、実際にバージョンが固定できているかも確認してみましょう。

別のプロジェクトディレクトリでバージョンを確認

テスト用に新たに二つ目のプロジェクトディレクトリを作成します。
先ほど作成した一つ目のプロジェクトディレクトリのpackage.jsonファイルを、二つ目のプロジェクトディレクトにコピーします。
package.jsonファイルがある状態で以下のNode.jsのバージョン確認コマンドを実行してみましょう。

node -v

package.jsonファイルの"volta"セクションにある"node"と同じバージョンが表示されたら成功です。

v14.21.2

Voltaをアンインストール

もしVoltaをアンインストールする場合は、以下の公式ページの手順に沿ってアンインストールを行なってください。

Voltaのアンインストール

まとめ

Voltaはクロスプラットフォーム対応で、簡単に導入することができるNode.jsのバージョン管理ツールです。
チーム開発ではさらに恩恵を感じられる為、是非導入していただければと思います。

Node.jsのバージョン管理ツール「Volta」のインストール・導入方法・使い方を解説

⚡️Voltaとは

Voltaの特徴１「Fast（速い）」

Voltaの特徴２「Reliable（信頼できる）」

Voltaの特徴３「Universal（ユニバーサル）」

Node.jsをアンインストール

Voltaをインストール

Volta本体をインストール

Macでのインストール方法

Windowsでのインストール方法

Voltaがインストールされているか確認

Node.jsをインストール

最新のLTS（安定版）をインストール（推奨）

LTS（安定版）

バージョンを指定してインストール

指定したバージョンのLTS（安定版）をインストール

指定したバージョンをインストール

最新版をインストール

インストールの確認

バージョンの変更方法

npmの確認

プロジェクトでバージョンを固定する

プロジェクトを作成

package.json

「volta pin」コマンドでバージョンを固定

別のプロジェクトディレクトリでバージョンを確認

Voltaをアンインストール

まとめ

⚡️Voltaとは

Voltaの特徴１「Fast（速い）」

Voltaの特徴２「Reliable（信頼できる）」

Voltaの特徴３「Universal（ユニバーサル）」

Node.jsをアンインストール

Voltaをインストール

Volta本体をインストール

Macでのインストール方法

Windowsでのインストール方法

Voltaがインストールされているか確認

Node.jsをインストール

最新のLTS（安定版）をインストール（推奨）

LTS（安定版）

バージョンを指定してインストール

指定したバージョンのLTS（安定版）をインストール

指定したバージョンをインストール

最新版をインストール

インストールの確認

バージョンの変更方法

npmの確認

プロジェクトでバージョンを固定する

プロジェクトを作成

package.json

「volta pin」コマンドでバージョンを固定

別のプロジェクトディレクトリでバージョンを確認

Voltaをアンインストール

まとめ

関連記事

【PostCSSの使い方】Web制作でCSSを拡張させる方法【autoprefixer・cssnano・postcss-combine-media-query】

【BrowserSync】WordPressのローカル環境をホットリロードさせる方法【Local・MAMP】

【cpx】npm-scriptsでファイル&フォルダのコピーのやり方

【BrowserSync】npm-scriptsで開発中のブラウザを自動更新する方法

npm-scriptsでEJSをhtmlにコンパイルする方法

【esbuild】npm-scriptsで複数のJSファイルを一つにバンドルする方法

【npm-run-all】npm-scriptsで複数の処理を一つのコマンドで同時に実行する方法

Windows環境でnpm-scriptsが実行されない場合の対処法