macOS で anyenv から nodenv をインストールして Node.js のバージョンを管理する

公開日 2026/04/26

更新日 2026/09/26

macOS で Homebrew から anyenv を導入し、nodenv で Node.js のバージョンを管理する手順。

anyenv のインストールとシェルの設定

brew install anyenv
anyenv install --init

anyenv install --init でインストール定義のリポジトリを取得するか確認されたら、y を入力する。初期化済みなら再実行は不要。

使用するシェルの設定ファイル いずれか一つ に次の行を追加する。

Zsh: ~/.zshrc
Bash: ~/.bashrc（環境によっては ~/.bash_profile）

eval "$(anyenv init -)"

設定ファイルを保存したら、ターミナルを開き直すかシェルを再起動する。

exec "$SHELL" -l

nodenv のインストールと確認

anyenv install nodenv
exec "$SHELL" -l
nodenv --version

nodenv install コマンドは node-build プラグインが提供する。次の手順でコマンドが見つからない場合は、プラグインをインストールする。

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

Node.js のインストールとバージョンの指定

# インストール可能な最新の安定版を表示
nodenv install -l

# 一覧から選んだバージョンをインストール（以下は例）
nodenv install 24.12.0

# デフォルトのバージョンを指定
nodenv global 24.12.0

# 適用されたバージョンを確認
node --version
nodenv version

プロジェクトごとに異なるバージョンを使う場合は、プロジェクトのディレクトリで nodenv local <バージョン> を実行する。このコマンドはカレントディレクトリに .node-version ファイルを作成する。

cd my-project
nodenv local 24.12.0
node --version

インストール済みのバージョンは nodenv versions で確認できる。nodenv install -l に必要なバージョンが表示されない場合は、node-build の更新方法を確認する。

nodenv の更新

anyenv でインストールした nodenv と node-build プラグインは、それぞれ Git で更新する。インストール可能な Node.js のバージョン一覧が古い場合は、node-build も更新する。

git -C "$(nodenv root)" pull
git -C "$(nodenv root)/plugins/node-build" pull

macOS で anyenv から nodenv をインストールして Node.js のバージョンを管理する

anyenv のインストールとシェルの設定

nodenv のインストールと確認

Node.js のインストールとバージョンの指定

nodenv の更新

参考資料