Skip to content

はじめに

Volta のインストール

Unix インストール

ほとんどの Unix システム(macOS を含む)では、一つのコマンドで Volta をインストールできます:

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

bash、zsh、fish において、このインストーラーは自動的にコンソール起動スクリプトを更新します。コンソール起動スクリプトの変更を防ぎたい場合は、Volta セットアップのスキップを参照してください。Volta を使用するようにシェルを手動設定するには、コンソール起動スクリプトを編集してください:

  • VOLTA_HOME 変数を $HOME/.volta に設定
  • $VOLTA_HOME/binPATH 変数の先頭に追加

Windows インストール

Windows では、winget を使用して Volta をインストールすることを推奨します:

bash
winget install Volta.Volta

お好みに応じて、インストーラーを直接ダウンロードして手動実行し、Volta をインストールすることもできます。

Windows Linux Subsystem

Windows Linux Subsystem で Volta を使用している場合は、上記の Unix インストールガイドに従ってください。

手動インストール

Volta を手動でインストールしたい場合は、下表からお使いのオペレーティングシステムに適したパッケージをダウンロードできます:

プラットフォームパッケージとインストール手順
Windows x86_64volta-2.0.2-windows-x86_64.msi
MSI ファイルをダブルクリックし、インストールウィザードに従ってください。インストーラーは自動的に Volta を PATH に追加します。
Windows ARM64volta-2.0.2-windows-arm64.msi
MSI ファイルをダブルクリックし、インストールウィザードに従ってください。インストーラーは自動的に Volta を PATH に追加します。
Windows x86_64 (ZIP)volta-2.0.2-windows.zip
ZIP ファイルをお選びの場所に展開してください。展開したディレクトリを PATH 環境変数に追加してください。
Windows ARM64 (ZIP)volta-2.0.2-windows-arm64.zip
ZIP ファイルをお選びの場所に展開してください。展開したディレクトリを PATH 環境変数に追加してください。
macOS x86_64/ARM64volta-2.0.2-macos.tar.gz
tarball を展開し、含まれているインストールスクリプトを実行:tar xzf volta-2.0.2-macos.tar.gz && ./volta-2.0.2-macos/install.sh
Linux x86_64volta-2.0.2-linux.tar.gz
tarball を展開し、含まれているインストールスクリプトを実行:tar xzf volta-2.0.2-linux.tar.gz && ./volta-2.0.2-linux/install.sh
Linux ARMvolta-2.0.2-linux-arm.tar.gz
tarball を展開し、含まれているインストールスクリプトを実行:tar xzf volta-2.0.2-linux-arm.tar.gz && ./volta-2.0.2-linux-arm/install.sh

Windows 手動インストール手順

  1. システムアーキテクチャ(x86_64 または ARM64)に対応する MSI インストーラーをダウンロード
  2. ダウンロードしたファイルをダブルクリックしてインストーラーを実行
  3. インストールウィザードの指示に従って進行
  4. インストーラーは自動的に Volta をシステムの PATH に追加
  5. 新しいコマンドプロンプトまたは PowerShell ウィンドウを開いて Volta の使用を開始

ZIP インストール方式:

  1. システムアーキテクチャに対応する ZIP ファイルをダウンロード
  2. ZIP ファイルをお選びのディレクトリに展開(例:C:\Program Files\Volta
  3. 展開したディレクトリをシステムの PATH 環境変数に追加
  4. 新しいコマンドプロンプトまたは PowerShell ウィンドウを開いて Volta の使用を開始

macOS 手動インストール手順

  1. macOS tarball をダウンロード
  2. ターミナルを開き、ダウンロード場所に移動
  3. tarball を展開してインストールスクリプトを実行:
    bash
    tar xzf volta-2.0.2-macos.tar.gz
    ./volta-2.0.2-macos/install.sh
  4. インストールスクリプトは以下を実行:
    • Volta バイナリを ~/.volta/bin に配置
    • Volta を PATH に追加するためにシェル設定ファイルを更新
  5. ターミナルを再起動するか、source ~/.bashrc(または対応するシェル設定ファイル)を実行

Linux 手動インストール手順

  1. システムアーキテクチャ(x86_64 または ARM)に対応する Linux tarball をダウンロード
  2. ターミナルを開き、ダウンロード場所に移動
  3. tarball を展開してインストールスクリプトを実行:
    bash
    tar xzf volta-2.0.2-linux.tar.gz
    ./volta-2.0.2-linux/install.sh
  4. インストールスクリプトは以下を実行:
    • Volta バイナリを ~/.volta/bin に配置
    • Volta を PATH に追加するためにシェル設定ファイルを更新
  5. ターミナルを再起動するか、source ~/.bashrc(または対応するシェル設定ファイル)を実行

デフォルト Node バージョンの選択

これは、Volta が固定バージョンのないプロジェクト以外でどこでも使用するバージョンです。

特定バージョンの Node を選択するには、次を実行:

bash
volta install node@22.5.1

または最新の LTS バージョンを使用するには、次を実行:

bash
volta install node

Volta でプロジェクトを管理

プロジェクトで Volta を使用するのは簡単です。次を実行するだけです:

bash
volta pin node@16

これにより package.json ファイルに volta セクションが追加され、すべてのプロジェクトメンバーが同じバージョンの Node.js を使用することが保証されます。

パッケージマネージャーも固定できます:

bash
volta pin npm@8

これにより、プロジェクトで npm を実行するたびに、Volta が指定されたバージョンを使用することを保証します。