文書の過去の版を表示しています。

volta

voltaはnodeのバージョン管理ツール。

Volta - The Hassle-Free JavaScript Tool Manager

インストール

公式サイトにある通りにインストールする

# install Volta
curl https://get.volta.sh | bash
 
# install Node
volta install node
 
# start using Node
node

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

volta install node@24

アンインストール

uninstallというサブコマンドはあるもののnodeのアンインストールは未サポートと出る。ファイルシステムから直接消せばOK

$ volta list node
⚡️ Node runtimes in your toolchain:

    v14.20.0
    v16.16.0
    v18.14.0
    v18.16.0 (default)

$ cd ~/.volta/tools/image/node
$ rm -rf 14.20.0
$ rm -rf 16.16.0

volta自身のアップデート

v1.1.1時点ではvolta自身をアップデートするコマンドは用意されていないが、再インストールすれば最新になる

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

デフォルトの変更

以下のファイルを修正する

~/.volta/tools/user/platform.json

使い方

nodeプロジェクトでnode v16を使用するには以下を実行する

volta pin node@v16

package.jsonにvoltaという項目が追加される。

  "volta": {
    "node": "16.16.0"
  }

voltaインストール済みで、16.16.0がインストールされてなければ、nodeを実行すると自動的に対象のバージョンがインストールされる。

プロジェクトメンバー間でのバージョン合わせや、特定ブランチのみバージョン変更といったケースに柔軟に対応できる

インストール済みnodeを確認

volta list node

一時的に別のバージョンで実行する

$ node -v
v18.16.0

$ volta run --node v12.22.5 node -v                                                                                        
v12.22.5

npmライブラリのインストール

npm管理されているコマンド類のインストール。npm install -gの代替

volta install @anthropic-ai/claude-code

インストール済みライブラリはlistサブコマンドで見れる

volta list

npmでグローバルインストールされたコマンドは、その時点のnodeのバージョンに紐付けられているためnodeをアップデートすると使えなくなるが、volta installでインストールしたコマンドはvolta管理下のnodeであればどのバージョンでも呼び出し可能。

volta管理下でのnpm install -gはvolta installと同等

npmライブラリのアンインストール

volta uninstall agent-browser

volta listでリストされる名前ではなく、install時に指定する名前空間付きの名称を指定する

補完を有効にする

独自の補完ファイル置き場（~/.zsh/completionなど）を作成

mkdir -p ~/.zsh/completion

.zshrcでfpathに追加する

if [[ -d ~/.zsh/completion ]]; then
	fpath=(~/.zsh/completion $fpath)
fi

補完ファイルを作成する

volta completions zsh -o ~/.zsh/completion/_volta

シェルを再起動して有効にする

Cat Paw Software

目次