MacのNode.js(nodejs)のバージョン管理をmiseで行う

ブログ
MacのNode.js(nodejs)のバージョン管理をmiseで行う

Node.js(以下 nodejs)のバージョン管理にはnodenv、asdf、volta、fnm、mise、protoなど複数の選択肢があります。

Rust実装で高速なものに限定すると volta、fnm、mise、proto となります。

多いですね。。。正直選ぶ手間の方がかかります。

全て一通り試した結果、当事務所では mise を推すことにしております。

miseをインストールする

miseはHomebrewでインストールできます。

# HomeBrew で mise をインストールする
brew install mise

公式インストールスクリプト経由の場合は~/.local/binに配置される仕様なので、Homebrew経由と混在はさせないほうがいいです。

# シェルコマンドで mise をインストールする
curl https://mise.run | sh

シェルへのactivate設定を行う

miseはインストールしただけではmise useの効果がシェルに反映されません。 zshの場合は~/.zshrcに以下の行を追記し、シェルを再起動(またはsource ~/.zshrc)する必要があります。

vi ~/.zshrc
eval "$(mise activate zsh)"

nodejsとpnpmをインストールする(miseコマンド)

nodejs@26 と pnpm@12 を mise コマンドからインストールします

mise use node@26
mise use pnpm@12

mise useはデフォルトでfuzzyバージョン(メジャー/マイナー範囲)をmise.tomlに保存する仕様になっています。 厳密にパッチバージョンまで固定したい場合は--pinオプションを付けて実行します。

mise use --pin node@26

プロジェクト単位ではなく全体のデフォルトにしたい場合は--globalを付けます。 実行すると~/.config/mise/config.tomlが更新されます。

mise use --global node@26

PHP intelephenseをインストールする(miseコマンド)

PHP intelephenseを mise コマンドからインストールします Intelephenseをmise経由でグローバルインストールするのでNode.jsのバージョンに依存しません

mise use -g npm:intelephense

Pythonをインストールする(miseコマンド)

Python を mise コマンドからインストールします

# Python 3.14 をインストールする
mise use [email protected]

# 全体のデフォルトにしたい場合は --global を付ける
mise use --global [email protected]

# インストール済みバージョンを確認する
python --version
which python

miseでインストールしたアプリの一覧とアップデートを確認する

mise でインストールしたすべてのアプリ(ツール)を一覧表示します

# インストール済みのツールとバージョンを一覧表示する
mise ls

インストール済みのツールに新しいバージョンがあるかどうかを確認します

# アップデートがあるツールを表示する(mise.toml で指定した範囲内)
mise outdated

# 指定範囲を超えた最新バージョンも含めて表示する
mise outdated --bump

miseを使ってインストールしたnodejs, pnpmのバージョンをアップグレードする

# キャッシュをクリアする
mise cache clear

# node.jsの最新バージョンを確認する
mise latest node

# アップグレードを実行する(nodejs)
mise upgrade node

# アップグレードを実行する(pnpm)
mise upgrade pnpm

# インストール済みバージョンを確認する
node -v
which node

pnpm -v
which pnpm

miseを使ってインストールした古いnodejs, pnpm , python を削除するる

# インストール済みのバージョンを確認する
mise ls node
mise ls pnpm
mise ls python

# どの設定ファイルからも使われていない古いバージョンを削除する(まずは --dry-run で確認)
mise prune --dry-run node pnpm python
mise prune node pnpm python

# 特定のバージョンを指定して削除する場合
mise uninstall [email protected]
一覧へ戻る