created: 2025/07/19,
modified: 2025/07/30
macのローカル環境にnode.jsをインストールする。インストールの仕方もいくつかあって、簡単に使いたい初心者向けか、プロジェクトごとに異なるバージョンを使い分けたいのか、目的や運用によって使い分けます。
公式サイトから直接ダウンロードするだけのため、初学者や初めてNode.jsを使う人に最適です。Node.jsのバージョンを頻繁に切り替えない場合で、セットアップやアップデートを難しく考えたくないユーザーにもあっています。
Node.js公式サイトにアクセスし、「LTS」安定版のインストーラ(.pkg)をダウンロードして手動インストールします。
Macの代表的なパッケージ管理ツール「Homebrew」を主に使っている方におすすめです。他の開発環境(Git、Pythonなど)との一括管理やアップデートを効率化したいときに便利です。
nvmはNode.jsバージョン管理の事実上の標準ツールであり、多くの開発者に使われていて情報も非常に多いです。一方、nodebrewは日本発でシンプルだが普及率は低めで情報も限られています。
使用するプロジェクトにもよりますが、Node.jsバージョンを分けたい場合は、使用者が多いnvmを使った方がいいかもしれません。
先に公式インストーラーで入れていてもnvmを後から導入して使い始めると、nvmの管理下のNode.jsが優先されます。
node.jsがインストールされる場所
| 方法 | インストール場所 | 備考 |
|---|---|---|
| 公式インストーラー | システム標準ディレクトリ(例:/usr/local/binなど) | 1バージョンのみ管理 |
| Homebrew | Homebrew管理ディレクトリ(例:/opt/homebrew/bin) | 1バージョンのみ |
| nvm | ユーザーのホームディレクトリ配下(~/.nvm/versions/node/{version}/bin) | 複数バージョン共存・切替可能 |
| nodebrew | ユーザーのホームディレクトリ配下(~/.nodebrew/node/{version}/bin) | 複数バージョン共存・切替可能 |
Macのデフォルトshellがzshなのでzshで行うようにします。まずはnvm(Node Version Manager)をインストールします。
もしHomebrewや公式インストーラーでNode.jsが入っている場合は、競合を避けるためアンインストールしておくことを推奨します。
Homebrew のアンインストール方法
brew uninstall node
nvmインストールスクリプトを実行
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.37.2/install.sh | zsh
.zshrcにnvmの初期化スクリプトが追加されているか確認
cat ~/.zshrc
...
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion" # This loads nvm bash_completion
シェルを再起動または以下を実行して設定を反映
source ~/.zshrc
nvmが正しくインストールされたか確認
nvm --version
LTS(安定版)をインストールするなら以下でOKです
nvm install --lts
Node.js のバーション確認
node -v
v22.17.1
特定バージョンを指定する場合
nvm install 18.16.0
インストール済みのバージョン表示
nvm ls
-> v22.17.1
default -> lts/* (-> v22.17.1)
iojs -> N/A (default)
unstable -> N/A (default)
node -> stable (-> v22.17.1) (default)
stable -> 22.17 (-> v22.17.1) (default)
lts/* -> lts/jod (-> v22.17.1)
lts/argon -> v4.9.1 (-> N/A)
lts/boron -> v6.17.1 (-> N/A)
lts/carbon -> v8.17.0 (-> N/A)
lts/dubnium -> v10.24.1 (-> N/A)
lts/erbium -> v12.22.12 (-> N/A)
lts/fermium -> v14.21.3 (-> N/A)
lts/gallium -> v16.20.2 (-> N/A)
lts/hydrogen -> v18.20.8 (-> N/A)
lts/iron -> v20.19.4 (-> N/A)
lts/jod -> v22.17.1
利用バージョンの切り替え
nvm use 18.16.0
Node.js のバーション確認
node -v
v22.17.1