これは、プロジェクトに基づいて対応する Node のバージョンを自動的に使用するツールであり、バージョンを切り替えるために nvm を毎回使用する必要はありません。
つまり、複数のプロジェクト間での Node のバージョンの切り替えを意識する必要はありません。
ダウンロード#
インストール#
公式の推奨インストール方法は次のとおりです。
注意
Volta の機能はシンボリックリンクの作成に依存しているため、次の操作が必要です:
- 開発者モードを有効にする(推奨)
- 昇格された権限で Volta を実行する(推奨されない)
デフォルトの Node バージョンを指定する#
以下のコマンドはすべて動作します
インストールされていない場合は、ダウンロードとインストールが実行されます。既に対応するバージョンがインストールされている場合、これらのステートメントはデフォルトの Node バージョンを切り替えるためのものと見なされます
# 最新バージョン、バージョンを指定しないか、node@latestと書く
volta install node
# メジャーバージョンを指定し、その後のすべての操作はvoltaが適切なバージョンを見つけるものとなります
volta install node@18
# 正確なバージョンを指定する
volta install node@12.22.10
ダウンロードに失敗した場合、手動でダウンロードできます#
阿里の node ミラーにアクセスして、必要なバージョンをクリックします
Windows の場合は win パッケージ、mac-intel の場合は darwin パッケージ、mac-arm の場合は arm パッケージをダウンロードします
ダウンロードが完了したら、Windows では通常、C:\Users\ユーザー名\AppData\Local\Volta\tools\image\node
に配置されます
現在の環境情報の確認#
volta list
コマンドを使用して、インストール済みの Node ランタイム、パッケージマネージャー、およびバイナリパッケージを確認できます。
volta list
volta list all
プロジェクトに移動する#
例えば、Node 12 のバージョンを使用する必要がある A プロジェクトがある場合、A プロジェクトでコマンドラインを開く必要があります
次のコマンドを実行します
volta pin node@12.22.10
volta pin yarn@1
# もちろん、volta pin node@12を正確に指定しないでください。voltaは適切なバージョンに切り替え/ダウンロードするでしょうが、お勧めしません。なぜなら、これによりコンピュータに多くの異なるバージョンのNode 12(この例ではnode)がダウンロードされる可能性があるからです
この時点で、プロジェクトのpackage.json
には追加の設定が表示されます。volta がインストールされていない場合、この設定は影響を与えませんが、volta がインストールされている場合、この設定はコンピュータ上の volta の動作を指示します
"volta": {
"node": "12.22.10"
}
pnpm の使用#
pnpm は現在実験的な段階にあります。有効にするには、環境変数 VOLTA_FEATURE_PNPM を 1 に設定してください。Windows では、これをユーザーまたはシステム環境変数のシステム設定に追加できます。Linux/Mac では、設定ファイルスクリプト(.bash_profile、.zshrc など)に値を設定できます。
このサポートは実験的なものであるため、pnpm は現在サポートされていません
グローバルインストール#
たとえば、pnpm install -g
とするとエラーが発生します。
移行#
現在、自動移行機能はありません。したがって、以前に pnpm を Volta のグローバルインストールとして使用していた場合は、手動で再インストールする必要がありますvolta install pnpm
。サポートを有効にし、再インストールする前に、以前にインストールされたパッケージをアンインストールすることができますvolta uninstall pnpm
。ネイティブ pnpm サポートに切り替えた後、同じコマンドを使用して分離された古いパッケージを削除することはできないかもしれませんが、現在はアンインストールの実装が不足しています。
終わりに#
これは volta を使用するための基本的な操作です。より高度な操作については、volta ドキュメントを参照してください。