nodenvというNodeバージョン管理ツールを使って、Node.js環境を構築します。

nodenvインストール

Homebrewでインストール

$ brew install nodenv

nodenvはnode-buildコマンドに依存していますが、このコマンド一発でnode-buildもインストールしてくれます。

一旦セットアップコマンドを実行する

$ eval "$(nodenv init -)"

ドキュメントではこのコマンドをシェルの設定ファイルに追記するよう書いてますが、【最後】で実施します。

※【最後】の工程までシェルを閉じたり再起動しないようにしてください。再起動してしまった場合は、上記のセットアップコマンドを再度実行してください。

nodenvコマンドが使えることを確認する

$ nodenv -v
nodenv 1.3.2

Node.jsインストール

バージョン一覧

インストールしたいバージョンを確認します。
ちなみに2020/05現在の最新推奨版(LTS)は12.16.3です。
最新推奨版(LTS)はNode.js公式ページで確認できます。

$ nodenv install -l
~~
12.16.1
12.16.2
12.16.3

インストール

$ nodenv install 12.16.3

グローバルに設定

$ nodenv global 12.16.3

インストールしただけでは使えないので、グローバルで使用するnodeのバージョンを指定します。

インストール確認

$ node -v
v12.16.3

$ npm -v
6.12.1

【必須】 nodenv-package-rehashプラグインのインストール

通常nodenvでグローバルにCLIコマンドアプリをインストールしても、その後に手動でnodenv rehashを実行しないとシムリンクが更新されないので、すぐ使えず面倒です。
例：npm install -g @vue/cliでvueコマンドをインストールしても、nodenv rehashを実行しないとvueコマンドが使えない。

このプラグインはシムリンクの更新を自動で行ってくれるので、nodenv rehashを手動で叩く必要がなくなります。

インストール

$ git clone https://github.com/nodenv/nodenv-package-rehash.git "$(nodenv root)"/plugins/nodenv-package-rehash

$ nodenv package-hooks install --all

　【最後】 シェル設定ファイルにnodenvセットアップコマンドを追記

ご利用のシェルの設定ファイルにセットアップコマンドを追記してください。
（デフォルトのシェルはmacOS Catalina以降ならzshなので.zprofile、macOS mojave以前ならbashなので.bash_profile）
プラグインを有効にするため、--no-rehashオプションを付けています。

# 手動追記する場合は、以下をシェル設定ファイルに追記
eval "$(nodenv init - --no-rehash)"

# 自動追記
# zshの場合
$ echo 'eval "$(nodenv init - --no-rehash)"' >> ~/.zprofile

# bashの場合
$ echo 'eval "$(nodenv init - --no-rehash)"' >> ~/.bash_profile

以上でnodenvのインストールはすべて完了です。

備考

nodenvをアップグレードする場合

brew upgrade nodenv node-build