Node.jsをバージョン管理する方法-Windows・Mac

Node.jsをバージョンアップする際、アンインストールして入れなおすのは面倒なので、バージョン管理ツールを使って、複数のNode.jsバージョンを使い分けられるようにした際のまとめです。

Windowsの場合

Windowsの場合、nodistというツールを使ってNode.jsのインストールやバージョン管理をおこないます。

nodistのインストール

nodistのインストール

nodist公式ページから最新版のインストーラをダウンロードして、nodistをインストールします。
コマンドプロンプトを使って、nodistがインストールされてコマンドが使えるようになったことを確認します。

nodist -v
PowerShell

0.9.1と表示されました。これでnodistのインストールが成功しました。

※powershellを使用している際に「nodist : このシステムではスクリプトの実行が無効になっているため、〜〜〜」というエラーメッセージが出る場合は以下の処理を行う。
powershellを一旦閉じて、「管理者として実行する」から実行します。
その後、以下のコマンドで実行権限を確認します。

Get-ExecutionPolicy
PowerShell

下記の

Restricted
PowerShell

となっているので、これを「Unrestricted」または「RemoteSigned」に変更します。

Set-ExecutionPolicy Unrestricted
PowerShell

を実行し、もう一度「Get-ExecutionPolicy」の実行結果をみて、「Unrestricted」になっていると成功です。

Node.jsのインストール

インストール可能なNode.jsのバージョンの一覧を表示します。
下記コマンドで使用可能なNode.jsのバージョン一覧が表示されます。

nodist dist
PowerShell

ここでは8.10.0のNode.jsをインストールします。

nodist + 8.2.0
PowerShell

次に、使用するバージョンを指定します。

nodist 8.2.0
PowerShell

確認のために、Node.jsのバージョンを確認してみます。

node -vv8.2.0
PowerShell

v8.10.0と表示されました。これでNode.jsのインストールが成功しました。

Node.jsのバージョン管理

バージョンを確認

node -v
PowerShell

バージョンを指定

nodist 8.2.0
PowerShell

インストール

nodist + v8.2.0
PowerShell

インストール済みのバージョン確認

nodist ls
PowerShell

nodist公式ページのインストーラーを使ってインストールしている場合

過去にnodist公式ページのインストーラーを使ってインストールしている場合、nodistでバージョン指定しても上手くいかない場合があります。
下記の方法で完全にアンインストールしてください。

  1. node.jsのアンインストーラーでアンインストール。
  2. アンインストーラーで消えていないフォルダ・ファイルを手動削除
    C:\program files\nodejs
    C:\Users\<ユーザー名>\AppData\Roaming\npm
    C:\Users\<ユーザー名>\AppData\Roaming\npm-chche
    C:\Users\<ユーザー名>.node_repl_history

Macの場合

Macの場合、nodebrewというツールを使ってNode.jsのインストールやバージョン管理をおこないます。

nodebrewのインストール

ターミナルを使ってnodebrewをインストールします。

brew install nodebrew
PowerShell

nodebrewがインストールされてコマンドが使えるようになったことを確認します。

nodebrew -v
PowerShell

nodebrewのセットアップ

nodebrew setup
PowerShell

環境変数の設定
.bash_profileに以下を追記

export PATH=/usr/local/var/nodebrew/current/bin:$PATHexport PATH=$HOME/.nodebrew/current/bin:$PATH
PowerShell

環境変数の反映

source .bash_profile
PowerShell

Node.jsのインストール

インストール可能なNode.jsのバージョンの一覧を表示します。
下記コマンドで使用可能なNode.jsのバージョン一覧が表示されます。

nodebrew ls-all
PowerShell

ここでは8.10.0のNode.jsをインストールします。

nodebrew install-binary v8.2.0
PowerShell

次に、使用するバージョンを指定します。

nodebrew use v8.2.0
PowerShell

確認のために、Node.jsのバージョンを確認してみます。

node -vv8.2.0
PowerShell

v8.10.0と表示されました。これでNode.jsのインストールが成功しました。

Node.jsのバージョン管理

バージョンを確認

node -v
PowerShell

バージョンを指定

nodebrew use 8.2.0
PowerShell

インストール

nodebrew install-binary v8.2.0
PowerShell

インストール済みのバージョン確認

nodebrew list
PowerShell

read next