はじめに
Volta のインストール
Unix インストール
ほとんどの Unix システム(macOS を含む)では、一つのコマンドで Volta をインストールできます:
curl https://get.volta.sh | bash
bash、zsh、fish において、このインストーラーは自動的にコンソール起動スクリプトを更新します。コンソール起動スクリプトの変更を防ぎたい場合は、Volta セットアップのスキップを参照してください。Volta を使用するようにシェルを手動設定するには、コンソール起動スクリプトを編集してください:
VOLTA_HOME
変数を$HOME/.volta
に設定$VOLTA_HOME/bin
をPATH
変数の先頭に追加
Windows インストール
Windows では、winget を使用して Volta をインストールすることを推奨します:
winget install Volta.Volta
お好みに応じて、インストーラーを直接ダウンロードして手動実行し、Volta をインストールすることもできます。
Windows Linux Subsystem
Windows Linux Subsystem で Volta を使用している場合は、上記の Unix インストールガイドに従ってください。
手動インストール
Volta を手動でインストールしたい場合は、下表からお使いのオペレーティングシステムに適したパッケージをダウンロードできます:
プラットフォーム | パッケージとインストール手順 |
---|---|
Windows x86_64 | volta-2.0.2-windows-x86_64.msi MSI ファイルをダブルクリックし、インストールウィザードに従ってください。インストーラーは自動的に Volta を PATH に追加します。 |
Windows ARM64 | volta-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/ARM64 | volta-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_64 | volta-2.0.2-linux.tar.gz tarball を展開し、含まれているインストールスクリプトを実行: tar xzf volta-2.0.2-linux.tar.gz && ./volta-2.0.2-linux/install.sh |
Linux ARM | volta-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 手動インストール手順
- システムアーキテクチャ(x86_64 または ARM64)に対応する MSI インストーラーをダウンロード
- ダウンロードしたファイルをダブルクリックしてインストーラーを実行
- インストールウィザードの指示に従って進行
- インストーラーは自動的に Volta をシステムの PATH に追加
- 新しいコマンドプロンプトまたは PowerShell ウィンドウを開いて Volta の使用を開始
ZIP インストール方式:
- システムアーキテクチャに対応する ZIP ファイルをダウンロード
- ZIP ファイルをお選びのディレクトリに展開(例:
C:\Program Files\Volta
) - 展開したディレクトリをシステムの PATH 環境変数に追加
- 新しいコマンドプロンプトまたは PowerShell ウィンドウを開いて Volta の使用を開始
macOS 手動インストール手順
- macOS tarball をダウンロード
- ターミナルを開き、ダウンロード場所に移動
- tarball を展開してインストールスクリプトを実行:bash
tar xzf volta-2.0.2-macos.tar.gz ./volta-2.0.2-macos/install.sh
- インストールスクリプトは以下を実行:
- Volta バイナリを
~/.volta/bin
に配置 - Volta を PATH に追加するためにシェル設定ファイルを更新
- Volta バイナリを
- ターミナルを再起動するか、
source ~/.bashrc
(または対応するシェル設定ファイル)を実行
Linux 手動インストール手順
- システムアーキテクチャ(x86_64 または ARM)に対応する Linux tarball をダウンロード
- ターミナルを開き、ダウンロード場所に移動
- tarball を展開してインストールスクリプトを実行:bash
tar xzf volta-2.0.2-linux.tar.gz ./volta-2.0.2-linux/install.sh
- インストールスクリプトは以下を実行:
- Volta バイナリを
~/.volta/bin
に配置 - Volta を PATH に追加するためにシェル設定ファイルを更新
- Volta バイナリを
- ターミナルを再起動するか、
source ~/.bashrc
(または対応するシェル設定ファイル)を実行
デフォルト Node バージョンの選択
これは、Volta が固定バージョンのないプロジェクト以外でどこでも使用するバージョンです。
特定バージョンの Node を選択するには、次を実行:
volta install node@22.5.1
または最新の LTS バージョンを使用するには、次を実行:
volta install node
Volta でプロジェクトを管理
プロジェクトで Volta を使用するのは簡単です。次を実行するだけです:
volta pin node@16
これにより package.json
ファイルに volta
セクションが追加され、すべてのプロジェクトメンバーが同じバージョンの Node.js を使用することが保証されます。
パッケージマネージャーも固定できます:
volta pin npm@8
これにより、プロジェクトで npm
を実行するたびに、Volta が指定されたバージョンを使用することを保証します。