🌊

NVMでNode.jsのバージョン管理をする

に公開
Node.js
nvm
tech

はじめに

Node.jsのバージョン管理はNVMを使っています。ここでは、基本的な使い方とバージョン切り替えを少し便利にするTipsを紹介します。

インストール

Githubリポジトリで説明されている方法にてインストールします。最新盤のインストールはリポジトリの記述を参照してください。

$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

インストール後 nvm コマンドで呼び出せるようにします。

$ export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm

基本的な使い方

nvm install nodeで最新版をインストールします

$ nvm install node

バージョン番号を指定すると、特定のバージョンをインストールできます

$ nvm install 14.7.0

nvm alias <エイリアス名> <バージョン> で特定のバージョンに名前を付けられます。プロジェクト名とかにしておくと切り替えが分かりやすくなります。

$ nvm alias my_alias v20.19.4
my_alias -> v20.19.4

削除時はnvm unalias <エイリアス名>です

$ nvm alias testalias current
testalias -> current (-> v24.5.0)
$ nvm unalias testalias
Deleted alias testalias - restore it with `nvm alias "testalias" "current"`

nvm ls-remote でインストール可能なバージョンの一覧が表示されます。

$ nvm ls-remote
    v0.1.14
    v0.1.15
    # 以下バージョンが続く

おまけ：プロジェクトごとにNode.jsのバージョンを自動で切り替える

プロジェクト毎にNode.jsのバージョンが違うのはよくあると思います。そのたびにnvm useを実行するのは手間なので、以下のようにプロジェクトのディレクトリに入ったら自動でバージョンが変更されるようにしておくと楽チンです。

プロジェクトのルートディレクトリに使用するバージョン/エイリアスを記載した.nvmrcファイルを用意します。

$ cd /your/project/directory
$ echo projectalias > .nvmrc

.bashrcや.zshrcにバージョン切り替えスクリプトを追加します

cd() {
    builtin cd "$@"
    if [ -f ".nvmrc" ]; then
        nvm use
    fi
}

.bashrcや.zshrcを再読み込みします。これで.nvmrc`が存在するディレクトリに移動した際、バージョンが変更されます。

$ source ~/.bashrc

Discussion