nvmでNodeのバージョン管理をしよう[mac]

nodeのバージョンを切り替える必要があり、nvmを使ってみようと思ったので、その際に調べたnvmの使い方をまとめておこうと思います。

nvm

nvm(node version manager)はNode.jsのバージョン管理ツールです。

使用パッケージやライブラリによってはある一定のNodeのバージョンでないと動作しない時があり、そのような時に簡単にNodeのversionを変更できるツールです。

インストール

zsh

brew install nvm

zsh

Please note that upstream has asked us to make explicit managing
nvm via Homebrew is unsupported by them and you should check any
problems against the standard nvm install method prior to reporting.

You should create NVM's working directory if it doesn't exist:
  mkdir ~/.nvm

Add the following to your shell profile e.g. ~/.profile or ~/.zshrc:
  export NVM_DIR="$HOME/.nvm"
  [ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"  # This loads nvm
  [ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"  # This loads nvm bash_completion

フォルダを作ります。

zsh

mkdir ~/.nvm

nano等でzshrcにパスを記載します。

export NVM_DIR="$HOME/.nvm"
  [ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"  # This loads nvm
  [ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"  # This loads nvm bash_completion

設定を反映させます。

zsh

source ~/.zshrc

インストールできるversionを確認する

ls-remoteを使うと、nvmでインストール可能なバージョンを確認できます。

zsh

nvm ls-remote

下のようにインストール可能な一覧を確認できます。

zsh

       v20.17.0   (Latest LTS: Iron)
        v21.0.0
        v21.1.0
        v21.2.0
        v21.3.0
        v21.4.0
        v21.5.0
        v21.6.0
        v21.6.1
        v21.6.2
        v21.7.0
        v21.7.1
        v21.7.2
        v21.7.3
        v22.0.0
        v22.1.0
        v22.2.0
        v22.3.0
        v22.4.0
        v22.4.1
        v22.5.0
        v22.5.1
        v22.6.0
        v22.7.0
        v22.8.0
        v22.9.0

特定のversionをインストールする

特定のversionをインストールするときはinstallコマンドを使用します。
例えばv18.20.4をインストールする時は、下のように行います。

zsh

nvm install v18.20.4

nvmで設定したnode.jsのversionは、馴染みのあるnodeの--versionで確認します。

zsh

node --version

nvmインストールされたversionが自動的に適応されます。

zsh

node --version
v18.20.4

バージョン切り替え

npm installで下のような表示が出た場合は、nodeのverを切り替える必要があると思います。

zsh

Expected version: v20.2.x
Got: v18.20.4

その場合は、useコマンドを使ってversionを変更します。

zsh

nvm use v20.2

nodeのversion変わってると思います。

zsh

node --version
v20.2.0

nvmにあるバージョンを確認する

下のコマンドでnvmに入っているバージョンを確認します。

zsh

nvm ls

下のような感じで出力されます。

zsh

       v18.20.4
->      v20.2.0
       v20.17.0

バージョンを削除する。

v18.20.4を削除したい時は、uninstallコマンドで削除します。

zsh

nvm uninstall v18.20.4

下のような出力が出たら消えています。

zsh

Uninstalled node v18.20.4

lsでも確認してみるとしっかり消えていました。

zsh

 nvm ls
->      v20.2.0
       v20.17.0

Nodeでバージョンを変更したいときはぜひ使ってみてください