Yuhan.jp

Node.js のバージョン管理を nodenv から asdf に変える

2026年7月20日(月)

最初に

備忘録メモ。

今更すぎる。

nodenv のアンインストール

homebrew でアンインストール。

$ brew uninstall nodenv

残存していた Node.js の削除

おそらく nodenv を利用する以前に公式インストーラー経由で入れたのであろう Node.js も残っており、ややこしかったので、それらも削除。

sudo rm /usr/local/bin/node
sudo rm /usr/local/bin/npm
sudo rm /usr/local/bin/npx
sudo rm /usr/local/bin/corepack

asdf

Node.js のプラグインを確認。

$ asdf plugin list all | grep node  
eks-node-viewer                             https://github.com/haad/asdf-eks-node-viewer.git
nodejs                                      *https://github.com/asdf-vm/asdf-nodejs.git

プラグインをインストール。

asdf plugin add nodejs

最新バージョンの Node.js をインストール。(記事時点だと 26.5.0)

asdf install nodejs latest

使用するバージョンを指定

asdf set -u nodejs 26.5.0

確認

asdf list

※補足参照

node -v

補足

asdf のバージョンアップ時の対応が漏れており、/opt/homebrew/opt/asdf/libexec/asdf.shの記述が .zshrcに残っていたので、下記に書き換えた。

ASDF_DATA_DIR の値は asdf infoで確認。

# asdf
export ASDF_DATA_DIR="/xxx/xxx/.asdf"
export PATH="$ASDF_DATA_DIR/shims:$PATH"

これがないと、 asdf 経由でインストールしたツールのパスが通らない。( 今回だとnodecommand not foundになる)

最後に

asdf を使っているようで微妙に使っていない、みたいな中途半端な状態だったので完全に移行した。

なんか、全体的にローカル環境が汚いので他にも掃除が必要そう。。。